times

README

サンプルリスト

このディレクトリには以下のサンプルがあります。

file	example name	note
time_since.go	time_since	time.Since() のサンプルです.
time_after.go	time_after	time.After() のサンプルです.
time_unix_to_time.go	time_unix_to_time	time.Unix(sec, nsec) のサンプルです.
time_now.go	time_now	time.Now() のサンプルです.
time_parse.go	time_parse	time.Parse() のサンプルです.
time_tick_and_ticker.go	time_tick_and_ticker	time.Tick と time.NewTicker の利用シーンの違いについてのサンプルです
time_timer.go	time_timer	time.NewTimer のサンプルです
time_afterfunc.go	time_afterfunc	time.AfterFunc のサンプルです
change_local_timezone.go	time_changelocaltimezone	time.Localを変更して強制的にローカルタイムゾーンを一時的に変更するサンプルです
time_json.go	time_json	time.Time を json 形式で扱う場合のサンプルです
time_json_custom.go	time_json_custom	time.Time をカスタム JSON エンコード・デコードで利用するサンプルです
time_in.go	time_in	time.In() の使い方のサンプルです
time_truncate.go	time_truncate	time.Truncate() のサンプルです。n分置き や n時間置き の時間を表現することができます。
time_truncate_hours.go	time_truncate_hours	time.Timeから時刻部分を除去するサンプルです.
time_change_timezone.go	time_change_timezone	time.Timeをいろいろなタイム・ゾーンの値に変換するサンプルです
time_format_datetime.go	time_format_datetime	Go1.20で追加された time.DateTime フォーマット書式についてのサンプルです
time_format_dateonly.go	time_format_dateonly	Go1.20で追加された time.DateOnly フォーマット書式についてのサンプルです
time_format_timeonly.go	time_format_timeonly	Go1.20で追加された time.TimeOnly フォーマット書式についてのサンプルです
time_format_millisecond.go	time_format_millisecond	time.Format() にてミリ秒を出力するサンプルです。
time_format_microsecond.go	time_format_microsecond	time.Format() にてマイクロ秒を出力するサンプルす。
time_calc_nextmonth.go	time_calc_nextmonth	翌月の日付を求めるサンプルです
time_daysinmonth.go	time_daysinmonth	月の日数を求めるサンプルです
time_sleep.go	time_sleep	time.Sleep() のサンプルです。
time_cancellable_sleep.go	time_cancellable_sleep	キャンセル可能なスリープ処理のサンプルです。
time_parseDuration.go	time_parse_duration	time.ParseDuration() のサンプルです

Documentation

Overview

Package times -- パッケージに関するサンプルが配置されています。

Index

• func AfterFunc() error
• func CalcNextMonth() error
• func CancellableSleep() error
• func ChangeLocalTimezone() error
• func ChangeTimeZone() error
• func DaysInMonth() error
• func FormatDateOnly() error
• func FormatDateTime() error
• func FormatMicrosecond() error
• func FormatMillisecond() error
• func FormatTimeOnly() error
• func NewRegister() mapping.Register
• func ParseDuration() error
• func Sleep() error
• func TickAndTicker() error
• func TimeAfter() error
• func TimeIn() error
• func TimeJson() error
• func TimeJsonCustom() error
• func TimeNow() error
• func TimeParse() error
• func TimeSince() error
• func TimeSub() error
• func TimeUnixToTime() error
• func Timer() error
• func Truncate() error
• func TruncateHours() error

Functions

func AfterFunc

func AfterFunc() error

AfterFunc は、time.AfterFunc のサンプルです。

func CalcNextMonth

func CalcNextMonth() error

CalcNextMonth は、翌月の日付を求めるサンプルです。

REFERENCES

• https://pkg.go.dev/time@go1.21.4

func CancellableSleep

func CancellableSleep() error

CancellableSleep は、キャンセル可能なスリープ処理のサンプルです。

time.Sleep() は、ブロックしてしまうためキャンセル可能な状態で スリープ処理を行いたい場合は、time.Tickerを利用して処理する。

REFERENCES

• https://pkg.go.dev/time@go1.22.2#NewTicker

func ChangeLocalTimezone

func ChangeLocalTimezone() error

ChangeLocalTimezone -- time.Localを変更して強制的にローカルタイムゾーンを一時的に変更するサンプルです.

REFERENCES

• https://pkg.go.dev/time#Location
• https://tutuz-tech.hatenablog.com/entry/2021/01/30/192956
• https://qiita.com/immrshc/items/a080975c6c7e23498944

func ChangeTimeZone

func ChangeTimeZone() error

ChangeTimeZone は、time.Timeをいろいろなタイム・ゾーンの値に変換するサンプルです.

func DaysInMonth

func DaysInMonth() error

DaysInMonth は、月の日数を求めるサンプルです.

REFERENCES

• https://cs.opensource.google/go/go/+/refs/tags/go1.21.4:src/time/time.go;l=1467

func FormatDateOnly

func FormatDateOnly() error

FormatDateOnly は、Go1.20で追加された time.DateOnly フォーマット書式についてのサンプルです.

REFERENCES

• https://pkg.go.dev/time@go1.20.2#pkg-constants

func FormatDateTime

func FormatDateTime() error

FormatDateTime は、Go1.20で追加された time.DateTime フォーマット書式についてのサンプルです.

REFERENCES

• https://pkg.go.dev/time@go1.20.2#pkg-constants

func FormatMicrosecond

func FormatMicrosecond() error

FormatMicrosecond は、time.Format() にてマイクロ秒を出力するサンプルです。

マイクロ秒をフォーマットするには ".000000" とする。 ドットを付けないとフォーマットされないので注意。

REFERENCES

• https://pkg.go.dev/time@go1.22.1#Time.Format

func FormatMillisecond

func FormatMillisecond() error

FormatMillisecond は、time.Format() にてミリ秒を出力するサンプルです。

ミリ秒をフォーマットするには ".000" とする。 ドットを付けないとフォーマットされないので注意。

REFERENCES

• https://pkg.go.dev/time@go1.22.1#Time.Format

func FormatTimeOnly

func FormatTimeOnly() error

FormatTimeOnly は、Go1.20で追加された time.TimeOnly フォーマット書式についてのサンプルです.

REFERENCES

• https://pkg.go.dev/time@go1.20.2#pkg-constants

func NewRegister

func NewRegister() mapping.Register

NewRegister -- このパッケージ用のサンプルを登録する mapping.Register を生成します。

func ParseDuration

func ParseDuration() error

ParseDuration は、time.ParseDuration() のサンプルです.

> ParseDuration parses a duration string. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".

> ParseDuration は継続時間文字列を解析する。 継続時間文字列は、符号付きの10進数列の可能性があり、 それぞれオプションの分数と "300ms"、"-1.5h"、"2h45m" のような単位の接尾辞があります。 有効な時間単位は、"ns"、"us"（または "µs"）、"ms"、"s"、"m"、"h "である。

REFERENCES

• https://pkg.go.dev/time@go1.22.3#ParseDuration

func Sleep

func Sleep() error

Sleep は、time.Sleep() のサンプルです。

> Sleep pauses the current goroutine for at least the duration d. A negative or zero duration causes Sleep to return immediately.

> スリープは、少なくとも継続時間dの間、現在のゴルーチンを一時停止します。継続時間が負またはゼロの場合、スリープは即座に戻ります。

REFERENCES

• https://pkg.go.dev/time@go1.22.2#Sleep

func TickAndTicker

func TickAndTicker() error

TickAndTicker -- time.Tick と time.NewTicker の利用シーンの違いについてのサンプルです。

func TimeAfter

func TimeAfter() error

TimeAfter は、 time.After() のサンプルです.

func TimeIn

func TimeIn() error

TimeIn -- time.In() の使い方のサンプルです。

日時自体は変更せずにタイムゾーンだけ変更する場合は, time.In() を利用します。

REFERENCES

• https://zenn.dev/hsaki/articles/go-time-cheatsheet#unix%E6%99%82%E9%96%93%E3%81%8B%E3%82%89time.time%E5%9E%8B%E3%81%B8%E3%81%AE%E5%A4%89%E6%8F%9B---time.unix%E9%96%A2%E6%95%B0

func TimeJson

func TimeJson() error

TimeJson -- time.Time を json 形式で扱う場合のサンプルです。

REFERENCES

• https://zenn.dev/hsaki/articles/go-time-cheatsheet#time.time%E5%9E%8B--%3E-json%E6%96%87%E5%AD%97%E5%88%97

func TimeJsonCustom

func TimeJsonCustom() error

TimeJsonCustom -- time.Time をカスタム JSON エンコード・デコードで利用するサンプルです.

REFERENCES

• https://zenn.dev/hsaki/articles/go-time-cheatsheet#jst(%E6%97%A5%E6%9C%AC%E6%A8%99%E6%BA%96%E6%99%82)%E3%82%92%E6%89%B1%E3%81%86%E5%A0%B4%E5%90%88

func TimeNow

func TimeNow() error

TimeNow は、 time.Now() のサンプルです.

func TimeParse

func TimeParse() error

TimeParse は、 time.Parse() のサンプルです.

func TimeSince

func TimeSince() error

TimeSince は、 time.Since() のサンプルです.

func TimeSub

func TimeSub() error

TimeSub は、 time.Sub() のサンプルです.

func TimeUnixToTime

func TimeUnixToTime() error

TimeUnixToTime は、 time.Unix(sec, nsec) のサンプルです.

func Timer

func Timer() error

Timer は、time.NewTimer のサンプルです。

func Truncate

func Truncate() error

Truncate -- time.Truncate() のサンプルです。n分置き や n時間置き の時間を表現することができます。

REFERENCES

• https://zenn.dev/mltokky/articles/20220426_golang_time_truncate

func TruncateHours

func TruncateHours() error

TruncateHours -- time.Timeから時刻部分を除去するサンプルです.

時刻部分を除去する場合は、 time.Truncate() に 24時間 を指定する.

REFERENCES:

• https://pkg.go.dev/time@latest#Time.Truncate