Note: you are viewing the development version of Schema.org. See How we work for more details.

duration

A Schema.org Property
Thing > Property :: duration
The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.

Values expected to be one of these types

Used on these types


Sub-properties

Source

https://github.com/schemaorg/schemaorg/issues/1698

https://github.com/schemaorg/schemaorg/issues/1457


Examples

Example 1
Copied
No Markup Microdata RDFa JSON-LD Structure
Example notes or example HTML without markup.
<b>12oclock_girona.mp3</b>
Total Time: 0m:15s - Recorded on a terrace of Girona a sunday morning
composed by Roger

 <script type="text/javascript">
var fo = new FlashObject("http://google.com/flash/preview-player.swf", "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url", "http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/AudioObject">
  <span itemprop="name"><b>12oclock_girona.mp3</b></span>

<script type="text/javascript">
  var fo = new FlashObject("http://google.com/flash/preview-player.swf",
  "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url","http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>

<meta itemprop="encodingFormat" content="audio/mpeg" />
 <meta itemprop="contentUrl" content="http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3" />

<span class="description">
      <meta itemprop="duration" content="T0M15S" />
      <span itemprop="description">Recorded on a terrace of Girona a sunday morning</span>
</span>
</div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="AudioObject">
  <span property="name"><b>12oclock_girona.mp3</b></span>

<script type="text/javascript">
  var fo = new FlashObject("http://google.com/flash/preview-player.swf",
  "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url","http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>

<meta property="encodingFormat" content="audio/mpeg" />
 <meta property="contentUrl" content="http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3" />

<span class="description">
      <meta property="duration" content="T0M15S" />
      <span property="description">Recorded on a terrace of Girona a sunday morning</span>
</span>
</div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "AudioObject",
  "contentUrl": "http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3",
  "description": "Recorded on a terrace of Girona a sunday morning",
  "duration": "T0M15S",
  "encodingFormat": "audio/mpeg",
  "name": "12oclock_girona.mp3"
}
</script>
Structured representation of the JSON-LD example.
Example 2
Copied
No Markup Microdata RDFa JSON-LD Structure
Example notes or example HTML without markup.
<h1>Foo Fighters</h1>

<h2>Video: Interview with the Foo Fighters</h2>
<object ...>
  <param ...>
  <embed type="application/x-shockwave-flash" ...>
</object>
Catch this exclusive interview with Dave Grohl and the Foo Fighters
 about their new album, Rope.

<h2>Songs</h2>

Rope
 Length: 4:05 - 14300 plays
<a href="foo-fighters-rope-play.html">Play</a>
<a href="foo-fighters-rope-buy.html">Buy</a>
From album: <a href="foo-fighters-wasting-light.html">Wasting Light</a>

Everlong
 Length: 6:33 - 11700 plays
<a href="foo-fighters-everlong-play.html">Play</a>
<a href="foo-fighters-everlong-buy.html">Buy</a>
From album: <a href="foo-fighters-color-and-shape.html">The Color And The Shape</a>

<h2>Upcoming shows</h2>

<a href="foo-fighters-may20-fedexforum">FedExForum</a>
Memphis, TN, US
May 20
<a href="ticketworlds.com/foofighters/may20-2011">Buy tickets</a>

<a href="foo-fighters-may23-midamericacenter">Mid America Center</a>
Council Bluffs, IA, US
May 23
<a href="ticketworlds.com/foofighters/may23-2011">Buy tickets</a>

<h2><a href="foo-fighters-photos">28 Photos</a></h2>
<a href="foofighters-1.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb1.jpg" /></a>
<a href="foofighters-2.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb2.jpg" /></a>
<a href="foofighters-3.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb3.jpg" /></a>

<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/MusicGroup">
    <h1 itemprop="name">
        Foo Fighters
    </h1>
    <div itemprop="subjectOf" itemscope itemtype="https://schema.org/VideoObject">
        <h2>
            Video: <span itemprop="name">Interview with the Foo Fighters</span>
        </h2>
        <meta itemprop="duration" content="PT1M33S">
        <meta itemprop="thumbnail" content="foo-fighters-interview-thumb.jpg"><object>
            <param>
             <embed type="application/x-shockwave-flash">
        </object> <span itemprop="description">Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.</span>
        <h3>
            Comments:
        </h3>Excited about seeing them in concert next week. -Lawrence , Jan 23 I dig their latest single. -Mary, Jan 19
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/CommentAction">
            <meta itemprop="userInteractionCount" content="18">
        </div>Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
        </div>
    <h2>
        Songs
    </h2>
    <div itemprop="track" itemscope itemtype="https://schema.org/MusicRecording">
        <span itemprop="name">Rope</span>
        <link itemprop="url" href="foo-fighters-rope.html">Length:
        <meta itemprop="duration" content="PT4M5S">4:05 - 14300 plays
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/ListenAction">
            <meta itemprop="userInteractionCount" content="14300">
        </div><a href="foo-fighters-rope-play.html" itemprop="audio">Play</a> <a href="foo-fighters-rope-buy.html" itemprop="offers">Buy</a> From album: <a href="foo-fighters-wasting-light.html" itemprop="inAlbum">Wasting Light</a>
    </div>
    <div itemprop="track" itemscope itemtype="https://schema.org/MusicRecording">
        <span itemprop="name">Everlong</span>
        <link itemprop="url" href="foo-fighters-everlong.html">Length:
        <meta itemprop="duration" content="PT6M33S">6:33 - 11700 plays
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/ListenAction">
            <meta itemprop="userInteractionCount" content="11700">
        </div><a href="foo-fighters-everlong-play.html" itemprop="audio">Play</a> <a href="foo-fighters-everlong-buy.html" itemprop="offers">Buy</a> From album: <a href="foo-fighters-color-and-shape.html" itemprop="inAlbum">The Color And The Shape</a>
    </div>
    <h2>
        Upcoming shows
    </h2>
    <div itemprop="event" itemscope itemtype="https://schema.org/Event">
        <a href="foo-fighters-may20-fedexforum" itemprop="url"><span itemprop="name">FedExForum</span></a> <span itemprop="location">Memphis, TN, US</span>
        <meta itemprop="startDate" content="2011-05-20">May 20 <a href="ticketmaster.com/foofighters/may20-2011" itemprop="offers">Buy tickets</a>
    </div>
    <div itemprop="event" itemscope itemtype="https://schema.org/Event">
        <a href="foo-fighters-may23-midamericacenter" itemprop="url"><span itemprop="name">Mid America Center</span></a> <span itemprop="location">Council Bluffs, IA, US</span>
        <meta itemprop="startDate" content="2011-05-23">May 23 <a href="ticketmaster.com/foofighters/may23-2011" itemprop="offers">Buy tickets</a>
    </div>
    <h2>
        <a href="foo-fighters-photos">28 Photos</a>
    </h2><a href="foofighters-1.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb1.jpg"></a> <a href="foofighters-2.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb2.jpg"></a> <a href="foofighters-3.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb3.jpg"></a>
</div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="MusicGroup">
    <h1 property="name">
        Foo Fighters
    </h1>
    <div property="subjectOf" typeof="VideoObject">
        <h2>
            Video: <span property="name">Interview with the Foo Fighters</span>
        </h2>
        <meta property="duration" content="PT1M33S">
        <meta property="thumbnail" content="foo-fighters-interview-thumb.jpg"><object>
            <param>
             <embed type="application/x-shockwave-flash">
        </object> <span property="description">Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.</span>
        <h3>
            Comments:
        </h3>Excited about seeing them in concert next week. -Lawrence , Jan 23 I dig their latest single. -Mary, Jan 19
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/CommentAction">
            <meta property="userInteractionCount" content="18">
        </div>Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
    </div>
    <h2>
        Songs
    </h2>
    <div property="track" typeof="MusicRecording">
        <span property="name">Rope</span>
        <link property="url" href="foo-fighters-rope.html">Length:
        <meta property="duration" content="PT4M5S">4:05 - 14300 plays
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/ListenAction">
            <meta property="userInteractionCount" content="14300">
        </div><a href="foo-fighters-rope-play.html" property="audio">Play</a> <a href="foo-fighters-rope-buy.html" property="offers">Buy</a> From album: <a href="foo-fighters-wasting-light.html" property="inAlbum">Wasting Light</a>
    </div>
    <div property="track" typeof="MusicRecording">
        <span property="name">Everlong</span>
        <link property="url" href="foo-fighters-everlong.html">Length:
        <meta property="duration" content="PT6M33S">6:33 - 11700 plays
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/ListenAction">
            <meta property="userInteractionCount" content="11700">
        </div><a href="foo-fighters-everlong-play.html" property="audio">Play</a> <a href="foo-fighters-everlong-buy.html" property="offers">Buy</a> From album: <a href="foo-fighters-color-and-shape.html" property="inAlbum">The Color And The Shape</a>
    </div>
    <h2>
        Upcoming shows
    </h2>
    <div property="event" typeof="Event">
        <a href="foo-fighters-may20-fedexforum" property="url"><span property="name">FedExForum</span></a> <span property="location">Memphis, TN, US</span>
        <meta property="startDate" content="2011-05-20">May 20 <a href="ticketmaster.com/foofighters/may20-2011" property="offers">Buy tickets</a>
    </div>
    <div property="event" typeof="Event">
        <a href="foo-fighters-may23-midamericacenter" property="url"><span property="name">Mid America Center</span></a> <span property="location">Council Bluffs, IA, US</span>
        <meta property="startDate" content="2011-05-23">May 23 <a href="ticketmaster.com/foofighters/may23-2011" property="offers">Buy tickets</a>
    </div>
    <h2>
        <a href="foo-fighters-photos">28 Photos</a>
    </h2><a href="foofighters-1.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb1.jpg"></a> <a href="foofighters-2.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb2.jpg"></a> <a href="foofighters-3.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb3.jpg"></a>
</div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "MusicGroup",
    "event": [
        {
            "@type": "Event",
            "location": "Memphis, TN, US",
            "offers": "ticketmaster.com/foofighters/may20-2011",
            "startDate": "2011-05-20",
            "url": "foo-fighters-may20-fedexforum"
        },
        {
            "@type": "Event",
            "location": "Council Bluffs, IA, US",
            "offers": "ticketmaster.com/foofighters/may23-2011",
            "startDate": "2011-05-23",
            "url": "foo-fighters-may23-midamericacenter"
        }
    ],
    "image": [
        "foofighters-1.jpg",
        "foofighters-2.jpg",
        "foofighters-3.jpg"
    ],
    "name": "Foo Fighters",
    "track": [
        {
            "@type": "MusicRecording",
            "audio": "foo-fighters-rope-play.html",
            "duration": "PT4M5S",
            "inAlbum": "foo-fighters-wasting-light.html",
            "interactionStatistic": {
                "@type": "InteractionCounter",
                "interactionType": "https://schema.org/ListenAction",
                "userInteractionCount": "14300"
            },
            "name": "Rope",
            "offers": "foo-fighters-rope-buy.html",
            "url": "foo-fighters-rope.html"
        },
        {
            "@type": "MusicRecording",
            "audio": "foo-fighters-everlong-play.html",
            "duration": "PT6M33S",
            "inAlbum": "foo-fighters-color-and-shape.html",
            "name": "Everlong",
            "interactionStatistic": {
                "@type": "InteractionCounter",
                "interactionType": "https://schema.org/ListenAction",
                "userInteractionCount": "11700"
            },
            "offers": "foo-fighters-everlong-buy.html",
            "url": "foo-fighters-everlong.html"
        }
    ],
    "subjectOf": {
        "@type": "VideoObject",
        "description": "Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.",
        "duration": "PT1M33S",
        "name": "Interview with the Foo Fighters",
        "thumbnail": "foo-fighters-interview-thumb.jpg",
        "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": "https://schema.org/CommentAction",
            "userInteractionCount": "18"
        }
    }
}
</script>
Structured representation of the JSON-LD example.