timex

v3.1.21

timex v3.1.21 Timex.Protocol protocol View Source

This protocol defines the API for functions which take a Date, NaiveDateTime, or DateTime as input.

Link to this section Summary

Types

t()

Functions

beginning_of_day(datetime)

Get a new version of the date/time value representing the beginning of the day

beginning_of_month(datetime)

Get a new version of the date/time value representing the beginning of it’s month

beginning_of_quarter(datetime)

Get a new version of the date/time value representing the beginning of it’s quarter

beginning_of_week(datetime, weekstart)

Get a new version of the date/time value representing the beginning of it’s week, providing a weekday name (as an atom) for the day which starts the week, i.e. :mon

beginning_of_year(datetime)

Get a new version of the date/time value representing the beginning of it’s year

century(datetime)

Get the century a date/time value is in

day(datetime)

Get the ordinal day number of the given date/time value

days_in_month(datetime)

Get the number of days in the month for the given date/time value

end_of_day(datetime)

Get a new version of the date/time value representing the end of the day

end_of_month(datetime)

Get a new version of the date/time value representing the ending of it’s month

end_of_quarter(datetime)

Get a new version of the date/time value representing the ending of it’s quarter

end_of_week(datetime, weekstart)

Get a new version of the date/time value representing the ending of it’s week, providing a weekday name (as an atom) for the day which starts the week, i.e. :mon

end_of_year(datetime)

Get a new version of the date/time value representing the ending of it’s year

from_iso_day(datetime, day)

Shifts the given date/time value to the ISO day given

is_leap?(datetime)

Return a boolean indicating whether the date/time value is in a leap year

is_valid?(datetime)

Determine if the provided date/time value is valid

iso_week(datetime)

Return a pair {year, week number} (as defined by ISO 8601) that the given date/time value falls on

quarter(datetime)

Get the quarter for the given date/time value

set(datetime, options)

Set fields on a date/time value using a list of unit/value pairs

shift(datetime, options)

Shift a date/time value using a list of shift unit/value pairs

to_date(datetime)

Convert a date/time value to a Date

to_datetime(datetime, timezone \\ :utc)

Convert a date/time value to a DateTime. An optional timezone can be provided, UTC will be assumed if one is not provided

to_erl(datetime)

Convert a date/time value to it’s Erlang tuple variant i.e. Date becomes {y,m,d}, DateTime/NaiveDateTime become {{y,m,d},{h,mm,s}}

to_gregorian_microseconds(datetime)

Convert a date/time value to gregorian microseconds (microseconds since the start of year zero)

to_gregorian_seconds(datetime)

Convert a date/time value to gregorian seconds (seconds since start of year zero)

to_julian(datetime)

Convert a date/time value to a Julian calendar date number

to_naive_datetime(datetime)

Convert a date/time value to a NaiveDateTime

to_unix(datetime)

Convert a date/time value to seconds since the UNIX Epoch

week_of_month(datetime)

Get the week number of the given date/time value, starting at 1

weekday(datetime)

Get the ordinal weekday number of the given date/time value

Link to this section Types

Link to this section Functions

Link to this function beginning_of_day(datetime) View Source

Get a new version of the date/time value representing the beginning of the day

Link to this function beginning_of_month(datetime) View Source

Get a new version of the date/time value representing the beginning of it’s month

Link to this function beginning_of_quarter(datetime) View Source

Get a new version of the date/time value representing the beginning of it’s quarter

Link to this function beginning_of_week(datetime, weekstart) View Source

Get a new version of the date/time value representing the beginning of it’s week, providing a weekday name (as an atom) for the day which starts the week, i.e. :mon.

Link to this function beginning_of_year(datetime) View Source

Get a new version of the date/time value representing the beginning of it’s year

Link to this function century(datetime) View Source

Get the century a date/time value is in

Link to this function day(datetime) View Source

Get the ordinal day number of the given date/time value

Link to this function days_in_month(datetime) View Source

Get the number of days in the month for the given date/time value

Link to this function end_of_day(datetime) View Source

Get a new version of the date/time value representing the end of the day

Link to this function end_of_month(datetime) View Source

Get a new version of the date/time value representing the ending of it’s month

Link to this function end_of_quarter(datetime) View Source

Get a new version of the date/time value representing the ending of it’s quarter

Link to this function end_of_week(datetime, weekstart) View Source

Get a new version of the date/time value representing the ending of it’s week, providing a weekday name (as an atom) for the day which starts the week, i.e. :mon.

Link to this function end_of_year(datetime) View Source

Get a new version of the date/time value representing the ending of it’s year

Link to this function from_iso_day(datetime, day) View Source

Shifts the given date/time value to the ISO day given

Link to this function is_leap?(datetime) View Source

Return a boolean indicating whether the date/time value is in a leap year

Link to this function is_valid?(datetime) View Source

Determine if the provided date/time value is valid.

Link to this function iso_week(datetime) View Source

Return a pair {year, week number} (as defined by ISO 8601) that the given date/time value falls on.

Link to this function quarter(datetime) View Source

Get the quarter for the given date/time value

Link to this function set(datetime, options) View Source

Set fields on a date/time value using a list of unit/value pairs

Link to this function shift(datetime, options) View Source

Shift a date/time value using a list of shift unit/value pairs

Link to this function to_date(datetime) View Source

Convert a date/time value to a Date

Link to this function to_datetime(datetime, timezone \\ :utc) View Source

Convert a date/time value to a DateTime. An optional timezone can be provided, UTC will be assumed if one is not provided.

Link to this function to_erl(datetime) View Source

Convert a date/time value to it’s Erlang tuple variant i.e. Date becomes {y,m,d}, DateTime/NaiveDateTime become {{y,m,d},{h,mm,s}}

Link to this function to_gregorian_microseconds(datetime) View Source

Convert a date/time value to gregorian microseconds (microseconds since the start of year zero)

Link to this function to_gregorian_seconds(datetime) View Source

Convert a date/time value to gregorian seconds (seconds since start of year zero)

Link to this function to_julian(datetime) View Source

Convert a date/time value to a Julian calendar date number

Link to this function to_naive_datetime(datetime) View Source

Convert a date/time value to a NaiveDateTime

Link to this function to_unix(datetime) View Source

Convert a date/time value to seconds since the UNIX Epoch

Link to this function week_of_month(datetime) View Source

Get the week number of the given date/time value, starting at 1

Link to this function weekday(datetime) View Source

Get the ordinal weekday number of the given date/time value