Time в Go: как работать с датой, временем, duration, parse, format и не ловить глупые баги с часовыми поясами

Что такое пакет time в Golang

Три главных типа, которые нужно понять сразу

Что такое time.Time

now := time.Now()
fmt.Printf("%T\n", now)

time.Time

То есть time.Time — это тип, который хранит дату, время и информацию о временной зоне

Что такое time.Duration

d := 5 * time.Second
fmt.Printf("%T %v\n", d, d)

Что такое time.Location

time.Time = точка во времени
time.Duration = длина промежутка
time.Location = где мы на это время смотрим

Почему тема времени почти всегда вылезает в реальной работе

time.Now и текущее время

time.Now()

package main
import (
"fmt"
"time"
)
func main() {
now := time.Now()
fmt.Println(now)
}

2026-06-09 14:32:10.123456789 +0300 EEST m=+0.000123456

Что здесь вообще напечаталось

2026-06-09 14:32:10.123456789 +0300 EEST

Почему текущее время не всегда локальное

Когда лучше сразу переводить в UTC

nowUTC := time.Now().UTC()
fmt.Println(nowUTC)

Как достать отдельные компоненты текущего времени

now := time.Now()
fmt.Println(now.Year())
fmt.Println(now.Month())
fmt.Println(now.Day())
fmt.Println(now.Hour())
fmt.Println(now.Minute())
fmt.Println(now.Second())
fmt.Println(now.Nanosecond())

Маленький пример из жизни

time.Date и создание даты вручную

time.Date(...)

birthday := time.Date(2024, time.April, 11, 10, 9, 8, 0, time.UTC)
fmt.Println(birthday)

2024-04-11 10:09:08 +0000 UTC

Что принимают аргументы time.Date

time.Date(year, month, day, hour, min, sec, nsec, loc)

Почему month — не просто число

time.January
time.February
time.March

Что будет, если передать странные значения

t := time.Date(2024, time.April, 34, 10, 0, 0, 0, time.UTC)
fmt.Println(t)

Когда time.Date полезнее, чем Parse

now := time.Now()
deadline := time.Date(now.Year(), now.Month(), now.Day(), 18, 0, 0, 0, now.Location())

Format: как форматировать дату и время

Mon Jan 2 15:04:05 MST 2006

Базовый пример Format

now := time.Now()
fmt.Println(now.Format("2006-01-02 15:04:05"))

2026-06-09 14:30:45

Почему именно 2006-01-02 15:04:05

2006 = год
01 = месяц
02 = день
15 = часы в 24-часовом формате
04 = минуты
05 = секунды

Самая частая ошибка новичка

now.Format("YYYY-MM-DD")

Полезные форматы, которые пригодятся сразу

now.Format("2006-01-02 15:04:05")

now.Format("2006-01-02")

now.Format("15:04:05")

now.Format("02.01.2006 15:04")

Готовые константы из пакета time

fmt.Println(now.Format(time.RFC3339))
fmt.Println(now.Format(time.DateOnly))
fmt.Println(now.Format(time.TimeOnly))
fmt.Println(now.Format(time.DateTime))
fmt.Println(now.Format(time.UnixDate))

Когда лучше использовать RFC3339

fmt.Println(time.Now().UTC().Format(time.RFC3339))

Parse и ParseInLocation: как парсить строки

layout := "2006-01-02 15:04:05"
value := "2026-06-09 14:30:45"
t, err := time.Parse(layout, value)
if err != nil {
fmt.Println("Ошибка:", err)
return
}
fmt.Println(t)

09.06.2026 14:30

"02.01.2006 15:04"

Пример с русским привычным форматом

layout := "02.01.2006"
value := "09.06.2026"
t, err := time.Parse(layout, value)
if err != nil {
panic(err)
}
fmt.Println(t)

Почему Parse часто даёт UTC, когда ты этого не ждал

Когда нужен ParseInLocation

loc, err := time.LoadLocation("Europe/Moscow")
if err != nil {
panic(err)
}
layout := "02.01.2006 15:04"
value := "09.06.2026 14:30"
t, err := time.ParseInLocation(layout, value, loc)
if err != nil {
panic(err)
}
fmt.Println(t)

Где это реально важно

2026-06-09 18:00:00

Гибкий парсинг нескольких форматов

func parseFlexibleTime(value string) (time.Time, error) {
layouts := []string{
time.RFC3339,
"2006-01-02 15:04:05",
"02.01.2006 15:04",
"2006-01-02",
}
for _, layout := range layouts {
if t, err := time.Parse(layout, value); err == nil {
return t, nil
}
}
return time.Time{}, fmt.Errorf("не удалось распарсить время: %s", value)
}

time.Duration, Add, AddDate, Sub, Since, Until

Что такое time.Duration простыми словами

5 * time.Second
2 * time.Minute
24 * time.Hour
150 * time.Millisecond

Базовый пример Duration

d := 2*time.Hour + 30*time.Minute
fmt.Println(d)
fmt.Println(d.Hours())
fmt.Println(d.Minutes())
fmt.Println(d.Seconds())

Add: прибавить длительность

now := time.Now()
future := now.Add(2 * time.Hour)
past := now.Add(-30 * time.Minute)
fmt.Println(future)
fmt.Println(past)

Почему Add не решает всё

AddDate: календарная арифметика

now := time.Now()
nextMonth := now.AddDate(0, 1, 0)
nextWeek := now.AddDate(0, 0, 7)
nextYear := now.AddDate(1, 0, 0)

Sub: разница между двумя моментами

start := time.Date(2026, time.June, 1, 10, 0, 0, 0, time.UTC)
end := time.Date(2026, time.June, 1, 12, 30, 0, 0, time.UTC)
diff := end.Sub(start)
fmt.Println(diff) // 2h30m0s

Since и Until

started := time.Now()
time.Sleep(2 * time.Second)
fmt.Println(time.Since(started))

deadline := time.Now().Add(10 * time.Minute)
fmt.Println(time.Until(deadline))

Before, After, Equal

fmt.Println(t1.Before(t2))
fmt.Println(t1.After(t2))
fmt.Println(t1.Equal(t2))

Почему == не лучший путь для time.Time

Пример из продуктового кода

Unix timestamp, JSON, API и база данных

Что такое Unix timestamp

now := time.Now()
fmt.Println(now.Unix())

fmt.Println(now.UnixMilli())

fmt.Println(now.UnixNano())

Как превратить timestamp обратно в time.Time

ts := time.Now().Unix()
t := time.Unix(ts, 0)
fmt.Println(t)

tsMs := time.Now().UnixMilli()
t := time.UnixMilli(tsMs)
fmt.Println(t)

Когда timestamp удобнее, чем строка

Время в JSON

type Event struct {
Name string `json:"name"`
At time.Time `json:"at"`
}

Время в API

Время в базе данных

Sleep, After, Timer и Ticker

time.Sleep

fmt.Println("start")
time.Sleep(2 * time.Second)
fmt.Println("done")

time.After

select {
case <-time.After(2 * time.Second):
fmt.Println("timeout")
}

Почему time.After часто показывают рядом с select

select {
case result := <-workCh:
fmt.Println(result)
case <-time.After(1 * time.Second):
fmt.Println("слишком долго")
}

Важный нюанс про time.After в цикле

time.NewTimer

timer := time.NewTimer(3 * time.Second)
<-timer.C
fmt.Println("timer fired")

if timer.Stop() {
fmt.Println("timer stopped")
}

time.AfterFunc

time.AfterFunc(2*time.Second, func() {
fmt.Println("run later")
})

time.NewTicker

ticker := time.NewTicker(1 * time.Second)
defer ticker.Stop()
for i := 0; i < 3; i++ {
<-ticker.C
fmt.Println("tick")
}

Почему ticker почти всегда надо Stop()

ticker := time.NewTicker(time.Second)
defer ticker.Stop()

Где это используется в реальной работе

Timezone, UTC и Local: где чаще всего баги

В чём корень проблемы

UTC

nowUTC := time.Now().UTC()
fmt.Println(nowUTC)

Local

fmt.Println(time.Now().Local())

LoadLocation и In

loc, err := time.LoadLocation("Europe/Moscow")
if err != nil {
panic(err)
}
nowMoscow := time.Now().In(loc)
fmt.Println(nowMoscow)

Самая частая практическая ошибка

Практическое правило для backend

Timezone bug, который реально легко словить

2026-06-09 18:00:00

Если приложение работает в нескольких странах

Частые ошибки новичков и вопросы на собеседовании

Что любят спрашивать на собеседовании

Практика: 8 коротких упражнений, чтобы тема time реально закрепилась

Упражнение 1. Текущее время

Упражнение 2. Создание даты

Упражнение 3. Форматирование

Упражнение 4. Парсинг строки

Упражнение 5. Duration и арифметика

Упражнение 6. AddDate и календарная логика

Упражнение 7. Таймаут через time.After

Упражнение 8. Ticker

Краткий итог

Шпаргалка по time в Golang

Мини-шаблоны, которые стоит забрать в работу

now := time.Now()

nowUTC := time.Now().UTC()

s := time.Now().Format("2006-01-02 15:04:05")

t, err := time.Parse("2006-01-02 15:04:05", value)

nextWeek := time.Now().AddDate(0, 0, 7)

select {
case <-workCh:
case <-time.After(2 * time.Second):
}

ticker := time.NewTicker(time.Second)
defer ticker.Stop()

Как самому проверить, что тема реально улеглась

Зачем вообще хорошо понимать time, если кажется, что это просто даты