gdドキュメント0.8.0

APIリファレンス

GD.time

Unix時刻、ISO 8601、HTTPの日付を変換・計算します。parse_isoはRFC 3339形式を受け取ります。加算や差分が64ビット整数の範囲を超える場合は、最大値または最小値になります。

メソッド

now

now() -> int
英語原文

Return the current Unix timestamp.

引数

引数はありません。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

to_parts

to_parts(unix: int) -> Dictionary
英語原文

Split a Unix timestamp into date-time components.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。

戻り値

Dictionary

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

from_parts

from_parts(parts: Dictionary) -> int
英語原文

Convert date-time components into a Unix timestamp.

引数

名前型省略時の値説明
partsDictionary省略不可組み立てる名前やパスなどの各部分。上に示した引数の型に合わせて渡します。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

to_iso

to_iso(unix: int) -> String
英語原文

Format a Unix timestamp as ISO 8601 text.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。

戻り値

String

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

to_http

to_http(unix: int) -> String
英語原文

Format a Unix timestamp as an HTTP date.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。

戻り値

String

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

parse_iso

parse_iso(text: String) -> int, Err
英語原文

Parse ISO 8601 text into a Unix timestamp.

引数

名前型省略時の値説明
textString省略不可調査・デコード・変換する文字列。入力自体は書き換えません。

戻り値

int, Err

エラー

処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。

add

add(unix: int, amount: int, unit: String = "second") -> int
英語原文

Add an amount in the specified unit to a Unix timestamp.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。
amountint省略不可加算する量。unitで指定する単位で数え、負数なら差し引きます。
unitString"second"時間の加算・比較に使う単位。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

diff

diff(a: int, b: int, unit: String = "second") -> int
英語原文

Return the difference between timestamps in the specified unit.

引数

名前型省略時の値説明
aint省略不可秒単位の1つ目のUnix時刻。
bint省略不可秒単位の2つ目のUnix時刻。
unitString"second"時間の加算・比較に使う単位。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

start_of_day

start_of_day(unix: int) -> int
英語原文

Return the start of the same UTC day.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

weekday

weekday(unix: int) -> int
英語原文

Return the weekday number for a Unix timestamp.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

is_leap

is_leap(year: int) -> bool
英語原文

Check whether a year is a leap year.

引数

名前型省略時の値説明
yearint省略不可日付計算に使う年。

戻り値

bool

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

days_in_month

days_in_month(year: int, month: int) -> int
英語原文

Return the number of days in a month.

引数

名前型省略時の値説明
yearint省略不可日付計算に使う年。
monthint省略不可1から12の月。

戻り値

int

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

ago

ago(unix: int, base: int = -1) -> String
英語原文

Format a timestamp relative to a reference time.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。
baseint-1基準にする秒単位のUnix時刻。

戻り値

String

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。

format

format(unix: int, pattern: String) -> String
英語原文

Format a Unix timestamp with the specified pattern.

引数

名前型省略時の値説明
unixint省略不可秒単位のUnix時刻。
patternString省略不可日時の書式パターン。

戻り値

String

エラー

この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。