View Source Cldr.Calendar.Gregorian (Cldr Calendars v1.26.1)

Implements the proleptic Gregorian calendar.

Intended to be plug-compatible with Calendar.ISO with additional functions to support localisation, date ranges for year, quarter, month and week.

When calling Cldr.Calendar.localize/3 on a Calendar.ISO-based date, those dates are first moved to this calendar acting as a localisation proxy.

Summary

Functions

Adds :year, :quarter, :month, :week increments

Identifies that the calendar is month based.

Returns the calendar year as displayed on rendered calendars.

Defines the CLDR calendar type for this calendar.

Returns the cyclic year as displayed on rendered calendars.

Returns {year, month, day} calculated from the number of iso_days.

Returns the number of days since the calendar epoch for a given year-month-day

Calculates the day and era from the given year, month, and day.

Calculates the day of the week from the given year, month, and day. It is an integer from 1 to 7, where 1 is Monday and 7 is Sunday.

Calculates the day of the year from the given year, month, and day.

Returns how many days there are in the given month.

Returns how many days there are in the given year-month.

Returns the number days in a week.

Returns the number days in a given year.

Returns the extended year as displayed on rendered calendars.

Returns the number of iso_days that is the first day of the given year for this calendar.

Calculates the ISO week of the year from the given year, month, and day. It is an integer from 1 to 53.

Returns the number of iso_days that is the last day of the given year for this calendar.

Returns if the given year is a leap year.

Returns a t:Date.Range representing a given month of a year.

Calculates the month of the year from the given year, month, and day. It is an integer from 1 to 12.

Converts the t:Calendar.iso_days format to the datetime format specified by this calendar.

Returns the t:Calendar.iso_days format of the specified date.

Calculates the number of period in a given year. A period corresponds to a month in month-based calendars and a week in week-based calendars.

Adds an increment number of date_parts to a year-month-day.

Returns a t:Date.Range representing a given quarter of a year.

Calculates the quarter of the year from the given year, month, and day. It is an integer from 1 to 4.

Returns the related gregorain year as displayed on rendered calendars.

Shifts a date by given duration.

Determines if the date given is valid according to this calendar.

Returns a t:Date.Range representing a given week of a year.

Calculates the week of the month from the given year, month, and day. It is an integer from 1 to 5.

Calculates the week of the year from the given year, month, and day. It is an integer from 1 to 53.

Returns the number weeks in a given year.

Returns a t:Date.Range representing a given year.

Calculates the year and era from the given year.

Calculates the year and era from the given year, month and day.

Functions

Link to this function

add(year, month, day, hour, minute, second, microsecond, atom, step)

View Source

Adds :year, :quarter, :month, :week increments

These functions support CalendarInterval

Identifies that the calendar is month based.

Link to this function

calendar_year(year, month, day)

View Source
@spec calendar_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: year :: Calendar.year() | {:error, {module(), String.t()}}

Returns the calendar year as displayed on rendered calendars.

Defines the CLDR calendar type for this calendar.

This type is used in support of Cldr.Calendar.localize/3. Currently only :gregorian or :japanese are supported.

Link to this function

cyclic_year(year, month, day)

View Source
@spec cyclic_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: year :: Calendar.year() | {:error, {module(), String.t()}}

Returns the cyclic year as displayed on rendered calendars.

Link to this function

date_from_iso_days(iso_days)

View Source

Returns {year, month, day} calculated from the number of iso_days.

Link to this function

date_to_iso_days(year, month, day)

View Source

Returns the number of days since the calendar epoch for a given year-month-day

Link to this function

day_of_era(year, month, day)

View Source
@spec day_of_era(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) ::
  {day :: Cldr.Calendar.day(), era :: Cldr.Calendar.era()}
  | {:error, {module(), String.t()}}

Calculates the day and era from the given year, month, and day.

Link to this function

day_of_week(year, month, day, atom)

View Source
@spec day_of_week(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day(),
  :default | atom()
) ::
  {day_of_week :: Calendar.day_of_week(),
   first_day_of_week :: Calendar.day_of_week(),
   last_day_of_week :: Calendar.day_of_week()}
  | {:error, {module(), String.t()}}

Calculates the day of the week from the given year, month, and day. It is an integer from 1 to 7, where 1 is Monday and 7 is Sunday.

Link to this function

day_of_year(year, month, day)

View Source
@spec day_of_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: day :: Calendar.day() | {:error, {module(), String.t()}}

Calculates the day of the year from the given year, month, and day.

@spec days_in_month(month :: Cldr.Calendar.month()) ::
  days ::
  Calendar.day() | {:error, {module(), String.t()}} | {:ambiguous, Range.t()}

Returns how many days there are in the given month.

If the days in month cannot be determined without knowning the year and error tuple is returned.

Link to this function

days_in_month(year, month)

View Source
@spec days_in_month(year :: Cldr.Calendar.year(), month :: Cldr.Calendar.month()) ::
  days ::
  Calendar.day() | {:error, {module(), String.t()}} | {:ambiguous, Range.t()}

Returns how many days there are in the given year-month.

Returns the number days in a week.

@spec days_in_year(year :: Cldr.Calendar.year()) ::
  days :: Calendar.day() | {:error, {module(), String.t()}}

Returns the number days in a given year.

Link to this function

extended_year(year, month, day)

View Source
@spec extended_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: year :: Calendar.year() | {:error, {module(), String.t()}}

Returns the extended year as displayed on rendered calendars.

Link to this function

first_gregorian_day_of_year(year)

View Source

Returns the number of iso_days that is the first day of the given year for this calendar.

Link to this function

iso_week_of_year(year, month, day)

View Source
@spec iso_week_of_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) ::
  {year :: Calendar.year(), week :: Cldr.Calendar.week()}
  | {:error, {module(), String.t()}}

Calculates the ISO week of the year from the given year, month, and day. It is an integer from 1 to 53.

Link to this function

last_gregorian_day_of_year(year)

View Source

Returns the number of iso_days that is the last day of the given year for this calendar.

@spec leap_year?(year :: Cldr.Calendar.year()) :: boolean()

Returns if the given year is a leap year.

Returns a t:Date.Range representing a given month of a year.

Link to this function

month_of_year(year, month, day)

View Source
@spec month_of_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: month :: Calendar.month() | {:error, {module(), String.t()}}

Calculates the month of the year from the given year, month, and day. It is an integer from 1 to 12.

Link to this function

naive_datetime_from_iso_days(arg)

View Source

Converts the t:Calendar.iso_days format to the datetime format specified by this calendar.

Link to this function

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

View Source

Returns the t:Calendar.iso_days format of the specified date.

@spec periods_in_year(year :: Cldr.Calendar.year()) :: Calendar.month()

Calculates the number of period in a given year. A period corresponds to a month in month-based calendars and a week in week-based calendars.

Link to this function

plus(year, month, day, date_part, increment, options \\ [])

View Source

Adds an increment number of date_parts to a year-month-day.

date_part can be :years, :quarters :months or :days.

Returns a t:Date.Range representing a given quarter of a year.

Link to this function

quarter_of_year(year, month, day)

View Source
@spec quarter_of_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) :: quarter :: Cldr.Calendar.quarter() | {:error, {module(), String.t()}}

Calculates the quarter of the year from the given year, month, and day. It is an integer from 1 to 4.

Link to this function

shift_date(year, month, day, duration)

View Source

Shifts a date by given duration.

Link to this function

shift_naive_datetime(year, month, day, hour, minute, second, microsecond, duration)

View Source

Shifts a naive date time by given duration.

Link to this function

shift_time(hour, minute, second, microsecond, duration)

View Source

Shifts a time by given duration.

Link to this function

valid_date?(year, month, day)

View Source

Determines if the date given is valid according to this calendar.

Returns a t:Date.Range representing a given week of a year.

Link to this function

week_of_month(year, week, day)

View Source
@spec week_of_month(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.week(),
  day :: Calendar.day()
) ::
  {month :: Calendar.month(), week :: Cldr.Calendar.week()}
  | {:error, {module(), String.t()}}

Calculates the week of the month from the given year, month, and day. It is an integer from 1 to 5.

Link to this function

week_of_year(year, month, day)

View Source
@spec week_of_year(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) ::
  {year :: Calendar.year(), week :: Cldr.Calendar.week()}
  | {:error, {module(), String.t()}}

Calculates the week of the year from the given year, month, and day. It is an integer from 1 to 53.

@spec weeks_in_year(year :: Cldr.Calendar.year()) ::
  {weeks :: Calendar.week(), days_in_last_week :: Calendar.day()}
  | {:error, {module(), String.t()}}

Returns the number weeks in a given year.

Note that for Gregorian month-based calendars the number of weeks returned will be 53 (not the sometimes expected 52) since there is always a week 53 with 1 or 2 (in a leap year) additional days in the last week.

Arguments

Returns

  • {weeks_in_year, days_in_last_week}

Example

iex> Cldr.Calendar.Gregorian.weeks_in_year(2019)
{53, 1}

iex> Cldr.Calendar.Gregorian.weeks_in_year(2020)
{53, 2}

Returns a t:Date.Range representing a given year.

@spec year_of_era(Cldr.Calendar.year()) ::
  {year :: Calendar.year(), era :: Cldr.Calendar.era()}

Calculates the year and era from the given year.

The ISO calendar has two eras: the current era which starts in year 1 and is defined as era "1". And a second era for those years less than 1 defined as era "0".

Link to this function

year_of_era(year, month, day)

View Source
@spec year_of_era(
  year :: Cldr.Calendar.year(),
  month :: Cldr.Calendar.month(),
  day :: Cldr.Calendar.day()
) ::
  {year :: Calendar.year(), era :: Cldr.Calendar.era()}
  | {:error, {module(), String.t()}}

Calculates the year and era from the given year, month and day.

The ISO calendar has two eras: the current era which starts in year 1 and is defined as era "1". And a second era for those years less than 1 defined as era "0".