WOLFRAM

Wolfram 语言与系统参考资料中心

DateDifference[date1,date2]

给出从 date1到 date2 的天数.

DateDifference[date1,date2,"unit"]

按指定的单位给出 date1 和 date2 之间的差值.

DateDifference[date1,date2,{"unit1","unit2",…}]

以列表形式给出对应于 "uniti" 的差值.

更多信息和选项
Details and Options Details and Options
范例  
基本范例  
范围  
日期格式  
单位  
选项  
DayCountConvention  
CalendarType  
Method  
应用  
属性和关系  
可能存在的问题  
参见
相关指南
历史
按以下格式引用：

DateDifference

DateDifference[date1,date2]

给出从 date1到 date2 的天数.

DateDifference[date1,date2,"unit"]

按指定的单位给出 date1 和 date2 之间的差值.

DateDifference[date1,date2,{"unit1","unit2",…}]

以列表形式给出对应于 "uniti" 的差值.

更多信息和选项

  • DateDifference 计算两个给定日期之间的时间量，将结果表示为物理持续时间或日历步长.
  • DateDifference 返回 Quantity 对象.
  • 日期可以被指定为如下的形式：
  • DateObject[…]日期对象
    {y,m,d}年、月、日
    {y,m}指定月份的第一天
    {y}y 年的1月1号
    "string"以字符串形式给出的日期 ("Jan. 1, 2022")
    {y,m,d,h,m,s}精确时间
    time绝对的时间规范
  • 可能的单位有 "Year"、"Quarter"、"Month"、"Week"、"Day"、"Hour"、"Minute"、"Second".
  • {y,m,d} 被视为等价于 {y,m,d,0,0,0}.
  • DateDifference 使用下列选项：
  • DayCountConvention "ActualActual"计数惯例，以此计算差值
    Method Automatic使用的日期算术方法
  • 对于具有可变持续时间（例如 "Month"）的添加时间步长，日期算术可以将这些步长转换为物理持续时间（连续算术）或将其全部视为离散日历步长（离散算术）.
  • 选项值 Method"Continuous" 实现连续运算. 离散算术通过 Methodrolling 实现，可能的滚动方法是"RollForward"、"RollBackward" 和 "RollOver"，默认为 "RollBackward".
  • 例如，对于离散算术，添加一个月可能会导致日期不存在（例如 2 月 30 日）. 在这种情况下，对于如何解决该日期，有三种可能的选择：
  • "RollBackward"回滚到最后一个存在的日期（2 月 28 日）
    "RollForward"前滚到下一个存在的日期（3 月 1 日）
    "RollOver"从下一个存在的日期开始递增（3 月 …）
  • DateDifference（以天数列举）遵循天数计算惯例，不管差值的幅度.
  • DateDifference[date2] 给出从当前时间直到 date2 的带小数点的天数.

范例

打开所有单元 关闭所有单元

基本范例  (4)

给出1月1日和7月4日之间的天数：

Wolfram Language code: DateDifference[DateObject[{2022, 1, 1}, "Day"], DateObject[{2022, 7, 4}, "Day"]]

使用按形式 {y,m,d} 确定的日期：

Wolfram Language code: DateDifference[{2022, 8, 29}, {2023, 1, 1}]

得出以星期为单位的日期差：

Wolfram Language code: DateDifference[DateObject[{2022, 1, 1}, "Day"], DateObject[{2022, 7, 4}, "Day"], "Week"]

以天、小时和分钟为单位计算日期差：

Wolfram Language code: DateDifference[DateObject[{2022, 1, 1}, "Day"], DateObject[{2022, 7, 4}, "Day"], {"Day", "Hour", "Minute"}]

范围  (8)

如果第二个日期在第一个日期之前，日期差是负的：

Wolfram Language code: DateDifference[DateObject[{2022, 7, 4}, "Day"], DateObject[{2022, 1, 1}, "Day"]]

If only one date is given, then the difference from the current date will be returned:

Wolfram Language code: DateDifference[Yesterday]

日期格式  (3)

给出 DateString 支持的任何形式的日期：

Wolfram Language code: DateDifference["May 9, 2021", "Nov 4, 2021"]

可以混合使用不同日期规范：

Wolfram Language code: DateDifference["May 9, 2021", DateObject[{2021, 11, 4}, "Day"]]

DateDifference 可以使用按 {y,m,d,h,m,s} 形式给出的时间：

Wolfram Language code: DateDifference[{2022, 1, 1, 5, 16, 17}, {2022, 1, 5, 7, 8, 11}]

单位  (3)

求两个日期之间的小时数：

Wolfram Language code: DateDifference[DateObject[{2022, 1, 1}, "Day"], DateObject[{2022, 6, 1}, "Day"], "Hour"]

求两个日期之间相差的年数：

Wolfram Language code: DateDifference[DateObject[{1936, 8, 14}, "Day"], DateObject[{2000, 12, 1}, "Day"], "Year"]

求两个日期之间相差的月数和天数：

Wolfram Language code: DateDifference[DateObject[{2023, 8, 14}, "Day"], DateObject[{2024, 12, 1}, "Day"], {"Month", "Day"}]

选项  (6)

DayCountConvention  (2)

在对某月的最后几天的计数上，不同的天数计算惯例会有所不同：

Wolfram Language code: Table[DateDifference[DateObject[{2022, 1, 31}, "Day"], DateObject[{2023, 1, 31}, "Day"], DayCountConvention -> i] + DateDifference[DateObject[{2023, 1, 31}, "Day"], DateObject[{2023, 2, 28}, "Day"], DayCountConvention -> i], {i, {"ThirtyEPlus360", "Thirty360", "Thirty360US"}}]

考虑天数计算惯例，计算相差的年份：

Wolfram Language code: DateDifference[DateObject[{2022, 1, 31}, "Day"], DateObject[{2023, 3, 31}, "Day"], "Year", DayCountConvention -> "Thirty360"]

CalendarType  (2)

计算犹太历中的日期差：

Wolfram Language code: DateDifference[{5373, 4, 3}, {5374, 4, 3}, CalendarType -> "Jewish"]

伊斯兰历年份比阳历年份短：

Wolfram Language code: With[{islam = First[CalendarConvert[Today, "Islamic"]]}, DateDifference[islam, islam + {4, 0, 0}, CalendarType -> "Islamic"]]

Method  (2)

默认情况下，3 月 31 日是 6 月 30 日之前的三个月：

Wolfram Language code: DateDifference[DateObject[{2022, 3, 31}, "Day"], DateObject[{2022, 6, 30}, "Day"], {"Month", "Day"}]

使用 Method"RollForward"，则日期相隔两个月零30天：

Wolfram Language code: DateDifference[DateObject[{2022, 3, 31}, "Day"], DateObject[{2022, 6, 30}, "Day"], {"Month", "Day"}, Method -> "RollForward"]

在比较两个日期时比较不同算术方法的结果：

Wolfram Language code: DateDifference[DateObject[{2020, 1, 30}], DateObject[{2023, 3, 1}], {"Month", "Day"}, Method -> #]& /@ {"Continuous", "RollForward", "RollBackward", "RollOver"}

应用  (2)

求自从 2000 年开始以来的年、月、日数:

Wolfram Language code: DateDifference[DateObject[{2000}, "Year", "Gregorian", -6.], DateObject[], {"Month", "Day", "Year"}]

在 3 月 21 日与 9 月 21 日之间总是间隔着 184 天：

Wolfram Language code: DateDifference[{2022, 3, 21}, {2022, 9, 21}]

如果不是闰年的话，9 月 21 日至下一年的 3 月 21 日之间间隔着 181 天：

Wolfram Language code: DateDifference[{2022, 9, 21}, {2023, 3, 21}]
Wolfram Language code: LeapYearQ[{2022, 3, 21}]

如果下一年是闰年，则间隔 182 天：

Wolfram Language code: DateDifference[{2023, 9, 21}, {2024, 3, 21}]
Wolfram Language code: LeapYearQ[{2020, 3, 21}]

属性和关系  (1)

DatePlus 对日期加上所给的时间段，而 DateDifference 计算日期之间的时间段：

Wolfram Language code: DateDifference[DateObject[{2022, 1}, "Month"], DateObject[{2022, 3}, "Month"], "Month"]
Wolfram Language code: DatePlus[DateObject[{2022, 1}, "Month"], %]

反过来做：

Wolfram Language code: DatePlus[DateObject[{2022, 1}, "Month"], {2, "Month"}]
Wolfram Language code: DateDifference[DateObject[{2022, 1}, "Month"], %, "Month"]

可能存在的问题  (2)

日期字符串可能有歧义：

Wolfram Language code: DateDifference["2/4/99", "Feb. 23, 1999"]

利用 DateList 消除不同解释所造成的歧义：

Wolfram Language code: DateDifference[DateObject[{"2/4/99", {"Day", "Month", "YearShort"}}], "Feb. 23, 1999"]

在先前发布的 Wolfram 语言版本中，DateDifference 返回的是纯数学结果. 可以通过 SetSystemOptions 启用该功能：

Wolfram Language code: DateDifference[Yesterday, Tomorrow]
Wolfram Language code: SetSystemOptions["DataOptions" -> "ReturnQuantities" -> False];
Wolfram Language code: DateDifference[Yesterday, Tomorrow]

通过将同一个系统选项值设置为 True，重新得到 Quantity 结果：

Wolfram Language code: SetSystemOptions["DataOptions" -> "ReturnQuantities" -> True];
Wolfram Language code: DateDifference[Yesterday, Tomorrow]
Wolfram Research (2007)，DateDifference，Wolfram 语言函数，https://reference.wolfram.com/language/ref/DateDifference.html （更新于 2022 年）.

文本

Wolfram Research (2007)，DateDifference，Wolfram 语言函数，https://reference.wolfram.com/language/ref/DateDifference.html （更新于 2022 年）.

CMS

Wolfram 语言. 2007. "DateDifference." Wolfram 语言与系统参考资料中心. Wolfram Research. 最新版本 2022. https://reference.wolfram.com/language/ref/DateDifference.html.

APA

Wolfram 语言. (2007). DateDifference. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/DateDifference.html 年

BibTeX

@misc{reference.wolfram_2026_datedifference, author="Wolfram Research", title="{DateDifference}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/DateDifference.html}", note=[Accessed: 21-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_datedifference, organization={Wolfram Research}, title={DateDifference}, year={2022}, url={https://reference.wolfram.com/language/ref/DateDifference.html}, note=[Accessed: 21-June-2026]}