8 Generic Time Operations

> (->time (time 124510))

#<time 12:45:10>
> (->time (datetime 1969721256))

#<time 02:56:00>
> (->time (moment 2015381#:tz"America/New_York"))

#<time 01:00:00>

procedure
( ->hours t)→(integer-in 023)
t:time-provider?

Returns the hour of the day from t.

Examples:

> (->hours (time 124510))

12
> (->hours (datetime 1969721256))

2
> (->hours (moment 2015381#:tz"America/New_York"))

1

procedure
( ->minutes t)→(integer-in 059)
t:time-provider?

Returns the minute of the hour from t.

Examples:

> (->minutes (time 124510))

45
> (->minutes (datetime 1969721256))

56
> (->minutes (moment 2015381#:tz"America/New_York"))

0

procedure
( ->seconds t[fractional?])

→
(if fractional?
(and/c rational? (>=/c 0)(</c 60))
(integer-in 059))
t:time-provider?
fractional?:boolean? =#f

Returns the seconds from t. If fractional? is #t, then the fraction of the second will be included; otherwise, the result is an integer.

Examples:

> (->seconds (time 124510123456789))

10
> (->seconds (datetime 196972125630123456789)#t)

30123456789/1000000000
> (->seconds (moment 201538100999999999#:tz"America/New_York")#t)

999999999/1000000000

procedure
( ->milliseconds t)→exact-integer?
t:time-provider?

Returns the milliseconds from t.

Examples:

> (->milliseconds (time 124510123456789))

123
> (->milliseconds (datetime 196972125630123456789))

123
> (->milliseconds (moment 201538100999999999#:tz"America/New_York"))

999

procedure
( ->microseconds t)→exact-integer?
t:time-provider?

Returns the microseconds from t.

Examples:

> (->microseconds (time 124510123456789))

123456
> (->microseconds (datetime 196972125630123456789))

123456
> (->microseconds (moment 201538100999999999#:tz"America/New_York"))

999999

procedure
( ->nanoseconds t)→exact-integer?
t:time-provider?

Returns the nanoseconds from t.

Examples:

> (->nanoseconds (time 124510123456789))

123456789
> (->nanoseconds (datetime 196972125630123456789))

123456789
> (->nanoseconds (moment 201538100999999999#:tz"America/New_York"))

999999999

procedure
( on-date td[#:resolve-offsetresolve])→datetime-provider?
t:time-provider?
d:date-provider?
resolve:offset-resolver/c =resolve-offset/raise

Combines the time fields of t with the date fields of d to produce a datetime provider. Any time zone information from t will be preserved in the result.

Examples:

> (on-date (time 0)(date 1970))

#<datetime 1970年01月01日T00:00:00>
> (on-date (datetime 1234567)(datetime 20201220))

#<datetime 2020年12月20日T04:05:06.000000007>

> (on-date (moment 2000112#:tz"America/New_York")
(date 201538)
#:resolve-offsetresolve-offset/post )

#<moment 2015年03月08日T03:00:00-04:00[America/New_York]>

top ← prev up next →