docs / stdlib / time

Stdlib index
  1. Overview
  1. Captured-borrow migration worklist (3.3.3)
  2. Owned-bind migration worklist (8.2.7)
  3. Return-side title audit — the ride-through enumeration
  4. stdlib ownership audit
  5. stdlib ownership dispositions (plan 1.3.1 / 4.3.1)

aot

  1. Components
  2. Scope
  3. Scoped

codec

  1. Base32
  2. Base64

codec / csv

  1. Csv

codec / json

  1. Json

collection

  1. ArrayList
  2. BPlusTree
  3. Cache
  4. Collectors
  5. HashMap
  6. HashSet
  7. Heap
  8. ImmutableList
  9. ImmutableMap
  10. ImmutableSet
  11. LinkedList
  12. RedBlackTree
  13. Sort

collection / ltm

  1. LtmBPlusTree

concurrent

  1. AtomicInt32
  2. AtomicInt64
  3. Channel
  4. Fiber
  5. FiberLocal
  6. Lock
  7. Mutex
  8. RwLock
  9. Semaphore
  10. Tasks

error

  1. Exception
  2. NoOptionalValueException
  3. NotProvidedException
  4. RecoverableException
  5. ScopedBuildFailedException
  6. ScopeNotActiveException
  7. Throwable
  8. UnrecoverableException

gfx

  1. Sampler
  2. Texture2D

hash

  1. DefaultHasher
  2. Hash
  3. SipHash
  4. XXHash3

ifx

  1. BackendRegistry
  2. Window

io

  1. Buffer

io / file

  1. File
  2. FileInfo
  3. FileReader
  4. FileWriter
  5. Path
  6. Watcher

io / net

  1. BufferPool
  2. ByteBuffer
  3. IpAddress
  4. Server
  5. ServerBuilder
  6. SocketAddress
  7. TcpListener
  8. TcpStream
  9. UdpSocket

io / net / dns

  1. Dns

io / net / uri

  1. Uri
  2. UriBuilder

lang

  1. Guid
  2. Math
  3. Optional
  4. Pair
  5. Slice
  6. String
  7. StringBuilder

lang / stream

  1. ArrayStream
  2. Stream

math

  1. Camera
  2. Color
  3. DType
  4. Ray
  5. Rotation
  6. Tensor
  7. Transform

math / fft

  1. Fft

math / linalg

  1. LinAlg

math / npio

  1. Npy

math / poly

  1. Poly

math / random

  1. Generator

math / stats

  1. Stats

nucleo

  1. Columns — the Arrow-laid-out substrate
  2. Fused tensor expressions — Fuse
  3. Table — the lazy, typed dataframe
  4. Tape — define-by-run autograd
  5. Transform intrinsics — Grad, Vmap, Jit

process

  1. Command
  2. Process

reflect

  1. Class

search / distance

  1. Distance

search / fuzzy

  1. Matcher

search / ngram

  1. Index

session

  1. PackageInstallException
  2. Packages

time

  1. Clock
  2. DateTimeFormatter
  3. Duration
  4. Instant
  5. LocalDate
  6. LocalDateTime
  7. LocalTime
  8. Period
  9. ZonedDateTime
  10. ZoneId
  11. ZoneOffset

wire

  1. Compressor
  2. CompressStream
  3. DecompressionLimitException
  4. Decompressor
  5. Encoder
  6. Schema
  7. SchemaEncoder

xpu

  1. Device
  2. KernelBuffer
  3. KernelStream
  4. KernelTimer

xpu / mesh

  1. MeshSimplifier

LocalDate

cajeta.time.LocalDate — an immutable calendar date (yyyy-MM-dd) with no time-of-day and no time-zone, on the proleptic Gregorian calendar, modeled on java.time.LocalDate. Stored canonically as a single int64 epoch-day count (days since 1970-01-01; negative before it); year/month/day parts are derived on access. A pure stack value type. Out-of-range or non-existent dates throw DateTimeException, and day-of-week follows ISO-8601 (Monday = 1 … Sunday = 7). Build one with the of/ofEpochDay factories; calendar arithmetic accepts a Period, and pairing with a LocalTime yields a LocalDateTime.

LocalDate d = LocalDate.of(2026, 6, 5);
LocalDate due = d.plusDays(40L);
boolean later = due.isAfter(d);   // true
String text #= due.iso();          // "2026-07-15"

Methods

Signature
LocalDate(int64 epochDay)Wraps a raw epoch-day directly (no validation)
static boolean isLeapYear(int32 year)True iff year is a Gregorian leap year
static int32 lengthOfMonth(int32 year, int32 month)Number of days in month (1..12) of year
static LocalDate of(int32 year, int32 month, int32 day) ⚑A validated date
static LocalDate ofEpochDay(int64 epochDay) ⚑The date epochDay days after 1970-01-01 (negative for earlier)
int32 getYear()Proleptic year
int32 getMonthValue()Month-of-year, 1..12
int32 getDayOfMonth()Day-of-month
int32 getDayOfWeek()ISO day-of-week: Monday = 1 … Sunday = 7
int64 toEpochDay()Days since 1970-01-01
boolean isLeap()True iff this date is in a leap year
LocalDate plusDays(int64 days)This date plus days days
LocalDate plusWeeks(int64 weeks)This date plus weeks weeks
LocalDate plusMonths(int64 months)This date plus months months
LocalDate plusYears(int64 years)This date plus years years (Feb 29 clamps to Feb 28 off leap years)
LocalDate plus(Period p)Plus a calendar Period: years and months applied together (day clamped to the resulting month), then days added
int32 compareTo(LocalDate other)Total order: earlier < later
boolean isBefore(LocalDate other)True iff strictly before other
boolean isAfter(LocalDate other)True iff strictly after other
int64 hash()Content hash of the epoch-day
#String iso()ISO-8601 yyyy-MM-dd (year padded to at least 4 digits; leading - for negative years)
static boolean operator== (LocalDate a, LocalDate b)Value equality — a == b

⚑ = @EntryPoint

See also

Source: docs/stdlib/time/LocalDate.md · 2 min read · 394 words