WOLFRAM

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

Duration[expr]

返回 expr 的持续时间.

Duration[expr,unit]

返回以指定 unit 表示的结果.

更多信息
Details and Options Details and Options
范例  
基本范例  
范围  
输入数据  
目标单位  
应用  
属性和关系  
参见
相关指南
历史
按以下格式引用：

Duration

Duration[expr]

返回 expr 的持续时间.

Duration[expr,unit]

返回以指定 unit 表示的结果.

更多信息

  • Duration 可以对各种具有相关时间长度的对象和实体进行计算.
  • 一些支持的对象有：
  • Audio[samples]样本长度除以采样率
    DateInterval[{start,end}]start 和 end 间的长度
    DateObject[…]由对象粒度给出的持续时间
    Entity[…]根据开始日期、结束日期及其他信息确定的持续时间
    Sound[prims]根据声音基元 prims 计算
    Sound[prims,t]
    Sound[prims,{tmin,tmax}]
    SampledSoundList[{a1,…,an},r]
    SampledSoundFunction[f,n,r]
    SoundNote[spec]
    SoundNote[spec,t]
    SoundNote[spec,{tmin,tmax}]
    MusicScore[…]根据事件持续的时间确定的时长
    MusicVoice[…]根据事件持续的时间确定的时长
    MusicMeasure[…]根据事件持续的时间确定的时长
    MusicNote[…]duration assuming 120 beats per minute
    MusicChord[…]假设每分钟 120 拍得出的时长
    MusicRest[…]假设每分钟 120 拍得出的时长
    TimeObject[…]由对象的粒度给出的持续时间
    TimeSeries[…]最后和第一两个时刻之差
    Video[…]视频、音频和字幕轨的大致时长
  • 默认情况下，给出结果会自动选择最能代表 expr 持续时间的单位来表示. 使用 Duration[expr,unit] 可指定单位.
  • 单位规格 unit 可以是下列任何一种：
  • Automatic自动确定单位
    unit与 "Seconds" 兼容的任何单位
    quantity任何有时间单位的量
    None以实数形式返回的持续时间，以秒为单位

范例

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

基本范例  (2)

Audio 对象的持续时间：

Wolfram Language code: Duration[\!\(\*AudioBox["![Embedded Audio Player](audio://content-hrzn8)"]\)]

DateInterval 的持续时间，以年为单位：

Wolfram Language code: Duration[DateInterval[{DateObject[{2015, 2, 4}, "Day", "Gregorian", -5.], DateObject[{2019, 8, 15}, "Day", "Gregorian", -5.]}], "Years"]

范围  (11)

输入数据  (9)

Sound 对象的时长：

Wolfram Language code: Duration[Sound[«1»]]

音符序列形成的声音：

Wolfram Language code: Duration[Sound[{SoundNote[0], SoundNote[1], SoundNote[2], SoundNote[3], SoundNote[4], SoundNote[5], SoundNote[6], SoundNote[7], SoundNote[8], SoundNote[9], SoundNote[10], SoundNote[11], SoundNote[12]}]]

MusicScore 对象：

Wolfram Language code: Duration[MusicScore[<|"VoiceList" -> {MusicVoice[<|"MeasureList" -> {MusicMeasure[<|"NoteList" -> {MusicNote[<|"Pitch" -> MusicPitch[<|"Accidental" -> 0, "Key" -> "G"|>], "Duration" -> MusicDuration[<|"BeatDuration" -> 1/4, ... BeatLength" -> 1|>]|>]}, "TimeSignature" -> MusicTimeSignature[<|"Numerator" -> 4, "Denominator" -> 4, "BeatLength" -> 1|>]|>]}, "TimeSignature" -> MusicTimeSignature[<|"Numerator" -> 4, "Denominator" -> 4, "BeatLength" -> 1|>]|>]]

Video 对象：

Wolfram Language code: Duration[Video["ExampleData/Caminandes.mp4"]]

TimeSeries 对象：

Wolfram Language code: ts = TimeSeries[{2, 1, 6, 5, 7, 4}, {{1, 2, 5, 10, 12, 15}}]
Wolfram Language code: Duration[ts]

金融时间序列的持续时间：

Wolfram Language code: ts = TimeSeries[FinancialData["MSFT", {"Jan. 1, 2010", "Sep. 1, 2010"}]]
Wolfram Language code: Duration[ts]

Entity 的持续时间：

Wolfram Language code: Duration[Entity["HistoricalPeriod", "EuropeanRenaissance"]]

DateObject 的持续时间：

Wolfram Language code: Duration[DateObject[{2022}]]

其结果取决于输入的粒度：

Wolfram Language code: Duration[DateObject[{2022, 8, 1}, "Week"]]

TimeObject 的持续时间：

Wolfram Language code: Duration[TimeObject[]]

其结果取决于输入的粒度：

Wolfram Language code: Duration[TimeObject[{11, 30}, "Minute"]]

目标单位  (2)

默认情况下，会选择一个合理的单位来表示结果：

Wolfram Language code: Duration[DateInterval[{DateObject[{2015, 2, 4}, "Day", "Gregorian", -5.], DateObject[{2019, 8, 15}, "Day", "Gregorian", -5.]}]]

指定目标单位：

Wolfram Language code: Duration[DateInterval[{DateObject[{2015, 2, 4}, "Day", "Gregorian", -5.], DateObject[{2019, 8, 15}, "Day", "Gregorian", -5.]}], "Weeks"]

使用量来指定目标单位：

Wolfram Language code: Duration[DateInterval[{DateObject[{2015, 2, 4}, "Day", "Gregorian", -5.], DateObject[{2019, 8, 15}, "Day", "Gregorian", -5.]}], Quantity[1, "Seconds"]]

使用 None 作为第二个参数，以实数形式返回持续时间，以秒为单位：

Wolfram Language code: Duration[Audio@"ExampleData/rule30.wav", None]

应用  (1)

获取以秒为单位的 Audio 持续时间：

Wolfram Language code: a = ExampleData[{"Audio", "SubwayTrain"}];
Wolfram Language code: Duration[a]

以分钟表示的持续时间：

Wolfram Language code: UnitConvert[%, "Minutes"]

属性和关系  (4)

Duration 自动优化结果的单位：

Wolfram Language code: Duration[AudioGenerator["Sin"]]
Wolfram Language code: Duration[Audio["http://exampledata.wolfram.com/bach.mp3"]]
Wolfram Language code: Duration[TimeSeries[FinancialData["GE", {"Jan/1/2010", "Feb/1/2010"}]]]

对于 Audio，采样数量除以采样率就等于持续时间：

Wolfram Language code: a = AudioGenerator["Sin", 2.5]

可以用采样数量除以采样率计算得到音频的持续时间：

Wolfram Language code: QuantityMagnitude@N[AudioLength[a] / AudioSampleRate[a]]

音频文件的持续时间可以直接从文件导入：

Wolfram Language code: Import["ExampleData/sample.flac", "Duration"]

和计算导入音频的持续时间比较：

Wolfram Language code: Import["ExampleData/sample.flac"]//Duration

Duration 返回视频文件的大致时长：

Wolfram Language code: Duration[Video["ExampleData/Caminandes.mp4"]]

与 Import 中的 "Duration" 元素相比：

Wolfram Language code: Import["ExampleData/Caminandes.mp4", "Duration"]

用 "ExactDurations" 元素获取所有轨的精确时长：

Wolfram Language code: Import["ExampleData/Caminandes.mp4", "ExactDurations"]

计算 "Duration" 通常比计算 "ExactDurations" 要快：

Wolfram Language code: First[RepeatedTiming[Import["ExampleData/Caminandes.mp4", #]]]& /@ {"Duration", "ExactDurations"}
Wolfram Research (2016)，Duration，Wolfram 语言函数，https://reference.wolfram.com/language/ref/Duration.html （更新于 2023 年）.

文本

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

CMS

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

APA

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

BibTeX

@misc{reference.wolfram_2026_duration, author="Wolfram Research", title="{Duration}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/Duration.html}", note=[Accessed: 11-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_duration, organization={Wolfram Research}, title={Duration}, year={2023}, url={https://reference.wolfram.com/language/ref/Duration.html}, note=[Accessed: 11-September-2026]}