Calendar.ISO

Реализация календаря, следующая стандарту ISO8601.

Этот календарь реализует пролептический григорианский календарь и поэтому совместим с календарём, используемым в большинстве стран сегодня. Пролептический означает, что правила григорианского високосного года применяются для всего времени, в результате чего даты дают разные результаты до 1583 года, когда был принят григорианский календарь.

Краткое описание

Функции

date_to_string(year, month, day): Преобразует заданную дату в строку
datetime_to_string(year, month, day, hour, minute, second, microsecond, time_zone, zone_abbr, utc_offset, std_offset): Преобразует объект datetime (с часовым поясом) в строку
day_of_week(year, month, day): Вычисляет день недели из заданных year, month, и day
days_in_month(year, month): Возвращает количество дней в заданном месяце года
leap_year?(year): Возвращает, является ли заданный год високосным
naive_datetime_to_string(year, month, day, hour, minute, second, microsecond): Преобразует объект datetime (без часового пояса) в строку

Типы

day()

day() :: 1..31

month()

month() :: 1..12

year()

year() :: 0..9999

Функции

date_to_string(year, month, day)

Преобразует заданную дату в строку.

datetime_to_string(year, month, day, hour, minute, second, microsecond, time_zone, zone_abbr, utc_offset, std_offset)

Преобразует объект datetime (с часовым поясом) в строку.

day_of_week(year, month, day)

day_of_week(year(), month(), day()) :: 1..7

Вычисляет день недели из заданных year, month, и day.

Это целое число от 1 до 7, где 1 — понедельник, а 7 — воскресенье.

Примеры

iex> Calendar.ISO.day_of_week(2016, 10, 31)
1
iex> Calendar.ISO.day_of_week(2016, 11, 01)
2
iex> Calendar.ISO.day_of_week(2016, 11, 02)
3
iex> Calendar.ISO.day_of_week(2016, 11, 03)
4
iex> Calendar.ISO.day_of_week(2016, 11, 04)
5
iex> Calendar.ISO.day_of_week(2016, 11, 05)
6
iex> Calendar.ISO.day_of_week(2016, 11, 06)
7

days_in_month(year, month)

days_in_month(year(), month()) :: 28..31

Возвращает количество дней в заданном месяце года.

Примеры

iex> Calendar.ISO.days_in_month(1900, 1)
31
iex> Calendar.ISO.days_in_month(1900, 2)
28
iex> Calendar.ISO.days_in_month(2000, 2)
29
iex> Calendar.ISO.days_in_month(2001, 2)
28
iex> Calendar.ISO.days_in_month(2004, 2)
29
iex> Calendar.ISO.days_in_month(2004, 4)
30

leap_year?(year)

leap_year?(year()) :: boolean()

Возвращает, является ли заданный год високосным.

Примеры

iex> Calendar.ISO.leap_year?(2000)
true
iex> Calendar.ISO.leap_year?(2001)
false
iex> Calendar.ISO.leap_year?(2004)
true
iex> Calendar.ISO.leap_year?(1900)
false

naive_datetime_to_string(year, month, day, hour, minute, second, microsecond)

Преобразует объект datetime (без часового пояса) в строку.