Media.durationString
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The durationString property retrieves a String value indicating the duration of the current media item in HH:MM:SS format.
Syntax
player.currentMedia.durationString
Possible Values
This property is a read-only String.
Remarks
If this property is used with a media item other than the one specified in Player.currentMedia, it may not contain a valid value. If the media item is less than an hour long, the HH: portion of the return value is omitted.
To retrieve the value of this property, read access to the library is required. For more information, see Library Access.
Examples
The following JScript example uses Media.durationString to display the duration of the current media item as formatted text. An HTML DIV element named MediaInfo displays the duration information. The Player object was created with ID = "Player".
<!-- Create an event handler to update the display when
the current media item changes. -->
<SCRIPT LANGUAGE = "JScript" FOR = Player EVENT = OpenStateChange(NewState)>
// Test whether the new media item is open.
if (NewState == 13){
// Write the formatted duration string to the DIV region.
MediaInfo.innerHTML = "Duration: " + Player.currentMedia.durationString;
}
</SCRIPT>
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player version 7.0 or later. |
| DLL |
|