times

nimony/lib/std/times.nim

The std/times module provides basic support for working with time.

This is a minimal implementation for Nimony: it covers Unix-epoch based points in time with nanosecond resolution, simple durations, and a calendar breakdown for UTC. For monotonic timestamps suitable for measuring durations, use std/monotimes.

type Month = HoleyEnum
func dollar`.Month(e: Month): string

type WeekDay = enum
  dMon = (0, "dMon")
  dTue = (1, "dTue")
  dWed = (2, "dWed")
  dThu = (3, "dThu")
  dFri = (4, "dFri")
  dSat = (5, "dSat")
  dSun = (6, "dSun")

func dollar`.WeekDay(e: WeekDay): string

type Time = object
  seconds: int64
  nanosecond: int32

type Duration = object
  seconds: int64
  nanosecond: int32

type DateTime = object
  year: int64
  month: Month
  monthday: int32
  hour: int32
  minute: int32
  second: int32
  nanosecond: int32
  weekday: WeekDay
  yearday: int32

func initTime(seconds: int64; nanoseconds: int64): Time
Creates a new Time from a Unix timestamp.
func fromUnix(unix: int64): Time
Convert a Unix timestamp (seconds since 1970-01-01 UTC) to a Time.
func toUnix(t: Time): int64
Converts t to a Unix timestamp.
func seconds(t: Time): int64
func nanosecond(t: Time): int32
func initDuration(seconds: int64; nanoseconds: int64; milliseconds: int64; microseconds: int64; minutes: int64; hours: int64; days: int64; weeks: int64): Duration
Creates a new Duration.
func inSeconds(d: Duration): int64
func inMilliseconds(d: Duration): int64
func inMicroseconds(d: Duration): int64
func inNanoseconds(d: Duration): int64
func ==(a: Time; b: Time): bool
func <(a: Time; b: Time): bool
func <=(a: Time; b: Time): bool
func ==(a: Duration; b: Duration): bool
func <(a: Duration; b: Duration): bool
func <=(a: Duration; b: Duration): bool
func -(a: Time; b: Time): Duration
Returns the duration between two times.
func +(t: Time; d: Duration): Time
Adds a duration to a time.
func -(t: Time; d: Duration): Time
Subtracts a duration from a time.
proc getTime(): Time
Gets the current time as a Time with up to nanosecond resolution.
func isLeapYear(year: int64): bool
Returns true if year is a leap year in the proleptic Gregorian calendar.
func getDaysInMonth(month: Month; year: int64): int32
Get the number of days in month of year.
func utc(t: Time): DateTime
Converts a Time to a DateTime in UTC.
func initDateTime(year: int64; month: Month; monthday: int32; hour: int32; minute: int32; second: int32; nanosecond: int32): DateTime
Creates a new DateTime in UTC.
func toTime(dt: DateTime): Time
Converts a DateTime to a Time. The DateTime is assumed to be in UTC.
proc now(): DateTime
Returns the current UTC date and time.
func $(dt: DateTime): string
Converts a DateTime to ISO-8601 format: YYYY-MM-DDTHH:MM:SS.
func $(t: Time): string
func $(d: Duration): string
Formats a Duration as Ns M.N (seconds.nanoseconds).