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)

codec

  1. 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. FiberLocal
  5. Lock
  6. Mutex
  7. RwLock
  8. Semaphore
  9. Tasks

error

  1. Exception
  2. NoOptionalValueException
  3. RecoverableException
  4. Throwable
  5. UnrecoverableException

gfx

  1. Sampler
  2. Texture2D

hash

  1. Blake3
  2. DefaultHasher
  3. Hash
  4. MD5
  5. Sha1
  6. Sha256
  7. SipHash
  8. 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. IpAddress
  2. Server
  3. ServerBuilder
  4. SocketAddress
  5. TcpListener
  6. TcpStream
  7. UdpSocket

io / net / dns

  1. Dns

io / net / tls

  1. TlsConnection
  2. TlsListener

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. Decompressor
  3. Encoder
  4. Schema
  5. SchemaEncoder

xpu

  1. Device
  2. KernelBuffer
  3. KernelStream

xpu / mesh

  1. MeshSimplifier

ZoneOffset

cajeta.time.ZoneOffset — a fixed offset from UTC, e.g. +05:30, -08:00, or Z (UTC), modeled on java.time.ZoneOffset. Stored as a single int32 total-seconds value in [-64800, 64800] (±18 hours); a pure stack value type. Build one through the of*/utc factories rather than the raw constructor — they range-check and throw DateTimeException on bad input. Fixed offsets are the zone backbone for ZonedDateTime; DST-aware region lookups live in ZoneId.

ZoneOffset ist = ZoneOffset.ofHoursMinutes(5, 30);
ZoneOffset pst = ZoneOffset.ofHours(-8);
boolean east = ist.compareTo(pst) > 0;   // true
String id #= ist.iso();                   // "+05:30"

Methods

Signature
ZoneOffset(int32 totalSeconds)A raw offset from a totalSeconds value; performs no range check
static ZoneOffset ofTotalSeconds(int32 totalSeconds)Offset of totalSeconds seconds from UTC; throws DateTimeException outside [-64800, 64800]
static ZoneOffset ofHours(int32 hours)Offset of whole hours; throws DateTimeException outside ±18
static ZoneOffset ofHoursMinutes(int32 hours, int32 minutes)Offset of hours and minutes; both parts must share the offset’s sign
static ZoneOffset utc()The UTC offset (zero), the Z of +00:00
int32 getTotalSeconds()Total offset in seconds from UTC (may be negative)
int32 compareTo(ZoneOffset other)Ascending order by offset seconds
int64 hash()Content hash of the offset seconds
#String iso()ISO offset id: Z for UTC, else +HH:mm / -HH:mm (:ss appended only for a nonzero seconds part)
static boolean operator== (ZoneOffset a, ZoneOffset b)Value equality — a == b

⚑ = @EntryPoint

See also

Source: docs/stdlib/time/ZoneOffset.md · 1 min read · 255 words