Skip to main content

Timestamps

Use xrpl/time to convert XRPL timestamps. Alias the import as xrpltime when also using Go's standard time package.

Convert to a Go time​

This offline example converts the start of the Ripple epoch to a Go time.Time, then converts it back:

package main

import (
	"fmt"
	"time"

	xrpltime "github.com/Peersyst/xrpl-go/xrpl/time"
)

func main() {
	const rippleSeconds int64 = 0
	t := time.Unix(xrpltime.RippleTimeToUnixSeconds(rippleSeconds), 0).UTC()
	fmt.Println(t.Format(time.RFC3339))
	fmt.Println(xrpltime.UnixTimeToRippleTime(t.Unix()))
}

Expected output:

2000-01-01T00:00:00Z
0

Check the units​

FunctionInputOutput
RippleTimeToUnixSecondsRipple secondsUnix seconds
RippleTimeToUnixTimeRipple secondsUnix milliseconds
UnixTimeToRippleTimeUnix secondsRipple seconds
RippleTimeToISOTimeRipple secondsUTC timestamp with millisecond formatting
IsoTimeToRippleTimeRFC3339 timestamp stringRipple seconds, or a parsing error

Despite their similar names, RippleTimeToUnixTime and UnixTimeToRippleTime are not unit-matched inverses. Use RippleTimeToUnixSeconds with time.Unix, or use time.UnixMilli for the milliseconds result. Subsecond precision is not retained in Ripple seconds.

See XRPL time representation for the protocol epoch and the Go API reference for all helpers.