Calendrical.Reform.Sweden.Transitional (Calendrical v1.1.0)

Copy Markdown

The transitional "Swedish calendar" in use between 1700 and 1712.

In 1700 Sweden began a gradual transition to the Gregorian calendar by omitting the leap day that year (there was no 29 February 1700). The plan was to drop every leap day from 1700 to 1740, at which point Sweden would have aligned with the Gregorian calendar. The plan was abandoned after 1700, so for the years 1700 to 1712 Sweden ran a unique calendar that was one day ahead of the Julian calendar and ten days behind the Gregorian calendar.

In 1712 Sweden reverted to the Julian calendar by inserting a second leap day that year — the only known instance of a 30 February. From 1 March 1712 the calendar realigned with the Julian calendar.

This module models that transitional calendar. It is not intended for direct use; it exists as the 1700–1712 segment of the Calendrical.Reform.Sweden composite calendar. Within that window each date maps to the same physical day as the Julian date bearing the same numbers, shifted back by one day, and the date 30 February 1712 is valid.

Summary

Functions

calendar_base()

Identifies whether this calendar is month or week based.

calendar_year(year, month, day)

Returns the calendar year as displayed on rendered calendars.

cldr_calendar_type()

Defines the CLDR calendar type for this calendar.

cyclic_year(year, month, day)

Returns the cyclic year as displayed on rendered calendars.

date_from_iso_days(iso_days)

Converts an ISO day number to a {year, month, day} in the transitional Swedish calendar.

date_to_iso_days(year, month, day)

Converts a year, month and day in the transitional Swedish calendar to an ISO day number.

day_of_era(year, month, day)

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

day_of_year(year, month, day)

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

days_in_month(month)

Returns how many days there are in the given month.

days_in_month(year, month)

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

days_in_week()

Returns the number days in a a week.

days_in_year(year)

Returns the number days in a given year.

epoch()
epoch_day_of_week()
extended_year(year, month, day)

Returns the extended year as displayed on rendered calendars.

first_day_of_week()
iso_week_of_year(year, month, day)

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

last_day_of_week()
leap_year?(year)

Returns whether year is a leap year in the transitional Swedish calendar.

month(year, month)

Returns a Date.Range.t/0 representing a given month of a year.

month_of_year(year, month, day)

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

months_in_leap_year()

Returns the number of months in a leap year.

months_in_ordinary_year()

Returns the number of months in a normal year.

months_in_year()

Returns the number of months in a year, without a year.

months_in_year(year)

Returns the number of months in a given year.

naive_datetime_from_iso_days(arg)

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

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

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

periods_in_year(year)

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

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

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

quarter(year, quarter)

Returns a Date.Range.t/0 representing a given quarter of a year.

quarter_of_year(year, month, day)

Returns the quarter of the year from the given year, month, and day.

related_gregorian_year(year, month, day)

Returns the related Gregorian year as displayed on rendered calendars.

valid_date?(year, month, day)

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

week(year, week)

Returns a Date.Range.t/0 representing a given week of a year.

week_of_month(year, month, day)

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

week_of_year(year, month, day)

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

weeks_in_year(year)

Returns the number of weeks in a given year.

year(year)

Returns a Date.Range.t/0 representing a given year.

year_of_era(year)

Calculates the year and era from the given year.

year_of_era(year, month, day)

Calculates the year and era from the given date.

Functions

calendar_base()

Identifies whether this calendar is month or week based.

calendar_year(year, month, day)

@spec calendar_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendar.year()

Returns the calendar year as displayed on rendered calendars.

cldr_calendar_type()

Defines the CLDR calendar type for this calendar.

This type is used in support of Calendrical. localize/3.

cyclic_year(year, month, day)

@spec cyclic_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendar.year()

Returns the cyclic year as displayed on rendered calendars.

date_from_iso_days(iso_days)

@spec date_from_iso_days(Calendrical.iso_day_number()) ::
  {Calendar.year(), Calendar.month(), Calendar.day()}

Converts an ISO day number to a {year, month, day} in the transitional Swedish calendar.

Arguments

  • iso_days is an integer ISO day number within the 1700–1712 window.

Returns

  • A {year, month, day} tuple.

Examples

iex> Calendrical.Reform.Sweden.Transitional.date_from_iso_days(
...>   Calendrical.Julian.date_to_iso_days(1712, 2, 29))
{1712, 2, 30}

date_to_iso_days(year, month, day)

@spec date_to_iso_days(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendrical.iso_day_number()

Converts a year, month and day in the transitional Swedish calendar to an ISO day number.

Arguments

  • year, month and day are the parts of a Swedish calendar date in the 1700–1712 window (30 February 1712 is accepted).

Returns

  • The integer ISO day number of the given date.

Examples

iex> Calendrical.Reform.Sweden.Transitional.date_to_iso_days(1712, 2, 30) ==
...>   Calendrical.Julian.date_to_iso_days(1712, 2, 29)
true

day_of_era(year, month, day)

@spec day_of_era(Calendar.year(), Calendar.month(), Calendar.day()) ::
  {day :: Calendar.day(), era :: Calendar.era()}

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

By default we consider on two eras: before the epoch and on-or-after the epoch.

day_of_year(year, month, day)

@spec day_of_year(Calendar.year(), Calendar.month(), Calendar.day()) :: Calendar.day()

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

days_in_month(month)

@spec days_in_month(Calendar.month()) ::
  Calendar.month()
  | {:ambiguous, Range.t() | [pos_integer()]}
  | {:error, :undefined}

Returns how many days there are in the given month.

Must be implemented in derived calendars because we cannot know what the calendar format is.

days_in_month(year, month)

@spec days_in_month(Calendar.year(), Calendar.month()) :: Calendar.month()

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

days_in_week()

Returns the number days in a a week.

days_in_year(year)

Returns the number days in a given year.

The year is the number of years since the epoch.

epoch()

epoch_day_of_week()

extended_year(year, month, day)

@spec extended_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendar.year()

Returns the extended year as displayed on rendered calendars.

first_day_of_week()

iso_week_of_year(year, month, day)

@spec iso_week_of_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  {:error, :not_defined}

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

By default this function always returns {:error, :not_defined}.

last_day_of_week()

leap_year?(year)

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

Returns whether year is a leap year in the transitional Swedish calendar.

Leap years follow the Julian rule; 1712 additionally carried the extra 30 February day.

Arguments

  • year is the year to test.

Returns

  • A boolean.

Examples

iex> Calendrical.Reform.Sweden.Transitional.leap_year?(1704)
true

month(year, month)

Returns a Date.Range.t/0 representing a given month of a year.

month_of_year(year, month, day)

@spec month_of_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendar.month() | {Calendar.month(), Calendrical.leap_month?()}

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

months_in_leap_year()

Returns the number of months in a leap year.

months_in_ordinary_year()

Returns the number of months in a normal year.

months_in_year()

Returns the number of months in a year, without a year.

Returns an integer when every year has the same number of months, or {:ambiguous, first..last} for lunisolar calendars whose year length varies (e.g. the Hebrew calendar's 12 or 13 months).

months_in_year(year)

Returns the number of months in a given year.

naive_datetime_from_iso_days(arg)

@spec naive_datetime_from_iso_days(Calendar.iso_days()) ::
  {Calendar.year(), Calendar.month(), Calendar.day(), Calendar.hour(),
   Calendar.minute(), Calendar.second(), Calendar.microsecond()}

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

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

@spec naive_datetime_to_iso_days(
  Calendar.year(),
  Calendar.month(),
  Calendar.day(),
  Calendar.hour(),
  Calendar.minute(),
  Calendar.second(),
  Calendar.microsecond()
) :: Calendar.iso_days()

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

periods_in_year(year)

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

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

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

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

quarter(year, quarter)

Returns a Date.Range.t/0 representing a given quarter of a year.

quarter_of_year(year, month, day)

@spec quarter_of_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  Calendrical.quarter()

Returns the quarter of the year from the given year, month, and day.

valid_date?(year, month, day)

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

week(year, week)

Returns a Date.Range.t/0 representing a given week of a year.

week_of_month(year, month, day)

@spec week_of_month(Calendar.year(), Calendar.month(), Calendar.day()) ::
  {pos_integer(), pos_integer()} | {:error, :not_defined}

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

By default this function always returns {:error, :not_defined}.

week_of_year(year, month, day)

@spec week_of_year(Calendar.year(), Calendar.month(), Calendar.day()) ::
  {:error, :not_defined}

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

By default this function always returns {:error, :not_defined}.

weeks_in_year(year)

Returns the number of weeks in a given year.

year(year)

Returns a Date.Range.t/0 representing a given year.

year_of_era(year)

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

Calculates the year and era from the given year.

year_of_era(year, month, day)

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

Calculates the year and era from the given date.