UFC - Unified Finance Client/com.ulalax.ufc.domain.model.earnings/EarningsCalendar

EarningsCalendar

data class EarningsCalendar(val symbol: String, val events: List<EarningsEvent>, val requestedLimit: Int, val requestedOffset: Int, val actualCount: Int)(source)

실적 발표 캘린더

Yahoo Finance Earnings Calendar API를 통해 조회한 실적 발표 일정을 나타냅니다. 특정 심볼에 대한 과거 및 미래 실적 발표 일정이 포함됩니다.

사용 예시:

val calendar = ufc.earningsCalendar("AAPL", limit = 12, offset = 0)

// 이벤트 조회
calendar.events.forEach { event ->
    println("${event.earningsDate}: EPS Estimate = ${event.epsEstimate}")
}

// 과거 실적 필터링
val historical = calendar.getHistoricalEvents()

Constructors

EarningsCalendar

constructor(symbol: String, events: List<EarningsEvent>, requestedLimit: Int, requestedOffset: Int, actualCount: Int)

Properties

val actualCount: Int

실제 반환된 이벤트 수

val events: List<EarningsEvent>

실적 이벤트 목록 (시간순 정렬)

val requestedLimit: Int

요청한 limit 파라미터

requestedOffset

val requestedOffset: Int

요청한 offset 파라미터

val symbol: String

티커 심볼 (예: "AAPL")

Functions

getFutureEvents

fun getFutureEvents(): List<EarningsEvent>

미래 예정 실적 이벤트만 필터링

getHistoricalEvents

fun getHistoricalEvents(): List<EarningsEvent>

과거 실적 이벤트만 필터링

getLatestHistoricalEarnings

fun getLatestHistoricalEarnings(): EarningsEvent?

가장 최근 과거 실적 조회

getNextEarnings

fun getNextEarnings(): EarningsEvent?

다음 예정된 실적 발표 일정 조회

fun isEmpty(): Boolean

이벤트가 비어있는지 확인

fun isNotEmpty(): Boolean

이벤트가 존재하는지 확인