首页 > 代码库 > calendar

calendar

模块说明

  • 本模块提供了本地时间、世界时间、星期几的计算和几个时间转换函数
  • local time 考虑了时区和夏令时,Universal time是取0经度的时间,且没有夏令时。反正是搞不明白了!!!
  • UTC(Universal Coordinated Time) 也叫GMT(Greenwich Mean Time),中文世界时间、格林威治时间、国际标准时间
  • local_time/0 和 universal_time/0 同时返回日期和时间,这是为了防止2次调用间跨天了。
    单独返回的date/0和time/0 强烈建议不用

  • 日期遵循公历
  • 日期时间差值计算应采用公历天数和秒数计数的函数,本地时间先转换为世界时间。
  • time_difference/2 不要用
  • 本模块当年第几周的定义遵从ISO8601标准。没读过该标准
  • stdlib文档标记了datetime1970(), 但函数使用了1970年前的日期似乎也可正确。搞不清楚了
  • erlang 从公元0年开始计算
  • erlang:now()  返回的是自1970年1月1日0时0分0秒的秒数元组{MegaSecs,Secs,MicroSecs}
  • 日期和时间来源于erlang:localtime/0  和 erlang:universaltime/0 

导出函数

  • date_to_gregorian_days(Date) -> Days
    date_to_gregorian_days(Year, Month, Day) -> Days
    返回日期的公历天数
  • datetime_to_gregorian_seconds(DateTime) -> Seconds
    返回日期时间的公历秒数
  • day_of_the_week(Date) -> daynum()
    day_of_the_week(Year, Month, Day) -> daynum()
    返回日期是星期几。1-Monday 2-Tuesday 等等
  • gregorian_days_to_date(Days) -> date()
    公历天数转日期
  • gregorian_seconds_to_datetime(Seconds) -> datetime()
    公历秒数转日期时间
  • is_leap_year(Year) -> boolean()
    是否闰年
  • iso_week_number() -> yearweeknum()    返回 local_time/0 对应日期的第几周
    iso_week_number(Date) -> yearweeknum()  返回Date 对应的第几周
  • last_day_of_the_month(Year, Month) -> LastDay
    某年某月多少天
  • local_time() -> datetime()
    操作系统告知的本地时间
  • local_time_to_universal_time(DateTime1) -> DateTime2
    本地时间转世界时,申明废弃;建议使用如下版本
  • local_time_to_universal_time_dst(DateTime1) -> [DateTime]
    同上,考虑了夏令时。返回[] 对应那些不存在的日期时间,比如夏令时从5时直接进入6时,那么中间的本地时间就没有对应了。

         返回 [DstDateTimeUTC,DateTimeUTC] 从夏令时改回来时,从6时改为5时,本地时间又走了一遍5时到6时,其中DstDateTimeUTC是夏令时起作用中;

         DateTimeUTC是改回来后。这样理解对吧?

         返回[DateTimeUTC] 对应那些一般日期时间

  • now_to_local_time(Now) -> datetime1970()
    erlang:now/0 的秒数元组转本地时间
  • now_to_universal_time(Now) ->datetime1970()
    now_to_datetime(Now) ->datetime1970()
    erlang:now/0的秒数元组转世界时
  • seconds_to_daystime(Seconds) -> {Days, Time}
    秒数转{天数,时间}
  • seconds_to_time(Seconds) -> time()
    限制一天内的秒数[0,86400)转时间
  • time_difference(T1, T2) -> {Days, Time}
    废弃
  • time_to_seconds(Time) -> secs_per_day()
    时间转秒数
  • universal_time() -> datetime()
    世界时
  • universal_time_to_local_time(DateTime) -> datetime()
    时间时转本地时间
















 

calendar