timex

v3.2.0

timex v3.2.0 Timex.Timezone View Source

This module is used for looking up the timezone information for a given point in time, in the desired zone. Timezones are dependent not only on locale, but the date and time for which you are querying. For instance, the timezone offset from UTC for Europe/Moscow is different for March 3rd of 2015, than it was in 2013. These differences are important, and as such, all functions in this module are date/time sensitive, and where omitted, the current date/time are assumed.

In addition to lookups, this module also does conversion of datetimes from one timezone period to another, and determining the difference between a date in one timezone period and the same date/time in another timezone period.

Link to this section Summary

Functions

beginning_of_day(dt)

Shifts the provided DateTime to the beginning of the day in it’s timezone

convert(date, tz)

Convert a date to the given timezone (either TimezoneInfo or a timezone name)

diff(dt, dest)

Determine what offset is required to convert a date into a target timezone

end_of_day(dt)

Shifts the provided DateTime to the end of the day in it’s timezone

exists?(zone)

Determines if a given zone name exists

get(tz, datetime \\ :calendar.universal_time())

Gets timezone info for a given zone name and date. The date provided can either be an Erlang datetime tuple, or a DateTime struct, and if one is not provided, then the current date and time is returned

local()

Gets the local timezone configuration for the current date and time

local(date)

Gets the local timezone configuration for the provided date and time. The provided date and time can either be an Erlang datetime tuple, or a DateTime struct

name_of(offset)

This function takes one of the varying timezone representations

resolve(tzname, datetime, utc_or_wall \\ :wall)

This version of resolve/3 takes a timezone name as a string, and an Erlang datetime tuple, and attempts to resolve the date and time in that timezone. Unlike the previous clause of resolve/2, this one will return either an error, a DateTime struct, or an AmbiguousDateTime struct

total_offset(timezone_info)
total_offset(std_offset, utc_offset)
tzdata_to_timezone(tzdata, zone)

Link to this section Functions

Link to this function beginning_of_day(dt) View Source 
beginning_of_day(DateTime.t()) :: DateTime.t()

Shifts the provided DateTime to the beginning of the day in it’s timezone

Link to this function convert(date, tz) View Source 
convert(date :: DateTime.t(), tz :: Timex.AmbiguousTimezoneInfo.t()) ::
  Timex.AmbiguousDateTime.t() | {:error, term()}
convert(date :: DateTime.t(), tz :: Timex.TimezoneInfo.t() | String.t()) ::
  DateTime.t() | Timex.AmbiguousDateTime.t() | {:error, term()}

Convert a date to the given timezone (either TimezoneInfo or a timezone name)

Link to this function diff(dt, dest) View Source 
diff(date :: DateTime.t(), tz :: Timex.TimezoneInfo.t()) ::
  integer() | {:error, term()}

Determine what offset is required to convert a date into a target timezone

Link to this function end_of_day(dt) View Source 
end_of_day(DateTime.t()) :: DateTime.t()

Shifts the provided DateTime to the end of the day in it’s timezone

Link to this function exists?(zone) View Source 
exists?(String.t()) :: boolean()

Determines if a given zone name exists

Link to this function get(tz, datetime \\ :calendar.universal_time()) View Source 
get(Timex.Types.valid_timezone(), Timex.Types.valid_datetime()) ::
  Timex.TimezoneInfo.t() | Timex.AmbiguousTimezoneInfo.t() | {:error, term()}

Gets timezone info for a given zone name and date. The date provided can either be an Erlang datetime tuple, or a DateTime struct, and if one is not provided, then the current date and time is returned.

Link to this function local() View Source 
local() ::
  Timex.TimezoneInfo.t() | Timex.AmbiguousTimezoneInfo.t() | {:error, term()}

Gets the local timezone configuration for the current date and time.

Link to this function local(date) View Source 
local(Timex.Types.valid_datetime()) ::
  Timex.TimezoneInfo.t() | Timex.AmbiguousTimezoneInfo.t() | {:error, term()}

Gets the local timezone configuration for the provided date and time. The provided date and time can either be an Erlang datetime tuple, or a DateTime struct.

Link to this function name_of(offset) View Source 
name_of(
  Timex.Types.valid_timezone()
  | Timex.TimezoneInfo.t()
  | Timex.AmbiguousTimezoneInfo.t()
) ::
  String.t()
  | {:error, {:invalid_timezone, term()}}
  | {:error, {:no_such_zone, term()}}
  | {:error, term()}

This function takes one of the varying timezone representations:

  • atoms
  • offset integers
  • shortcut names (i.e. :utc, :local, “Z”, “A”)

and resolves the full name of the timezone if it’s able.

If a string is provided which isn’t recognized, it is returned untouched, only when get/2 is called will the timezone lookup fail.

Link to this function resolve(tzname, datetime, utc_or_wall \\ :wall) View Source 
resolve(String.t(), non_neg_integer(), :utc | :wall) ::
  Timex.TimezoneInfo.t() | Timex.AmbiguousTimezoneInfo.t() | {:error, term()}
resolve(Timex.Types.valid_timezone(), Timex.Types.datetime(), :utc | :wall) ::
  DateTime.t() | Timex.AmbiguousDateTime.t() | {:error, term()}

This version of resolve/3 takes a timezone name as a string, and an Erlang datetime tuple, and attempts to resolve the date and time in that timezone. Unlike the previous clause of resolve/2, this one will return either an error, a DateTime struct, or an AmbiguousDateTime struct.

Link to this function total_offset(timezone_info) View Source
Link to this function total_offset(std_offset, utc_offset) View Source
Link to this function tzdata_to_timezone(tzdata, zone) View Source 
tzdata_to_timezone(map(), String.t()) :: Timex.TimezoneInfo.t()