duration

Canonical URL: http://schema.org/duration

Thing > Property > duration

The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.

Usage: Between 50,000 and 100,000 domains
Values expected to be one of these types
Duration
Used on these types
Event
MediaObject
Movie
MusicRecording
MusicRelease
Used on types defined in extensions
Audiobook - defined in the bib extension
Sub-properties
loanTerm


Examples

Example 1
Without Markup Microdata RDFa JSON-LD 
<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>

<div itemscope itemtype="http://schema.org/MusicGroup">
<h1 itemprop="name">Foo Fighters</h1>
<div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  <h2>Video: <span itemprop="name">Interview with the Foo Fighters</span></h2>
  <meta itemprop="duration" content="T1M33S" />
  <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>
</div>
<h2>Songs</h2>
<div itemprop="track" itemscope itemtype="http://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="interactionCount" itemscope itemtype="http://schema.org/InteractionCounter">
    <meta itemprop="interactionType" content="http://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="http://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="interactionCount" itemscope itemtype="http://schema.org/InteractionCounter">
    <meta itemprop="interactionType" content="http://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="http://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="http://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>
<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
<div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter">
  <meta itemprop="interactionType" content="http://schema.org/CommentAction" />
  <meta itemprop="userInteractionCount" content="18" />
</div>
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
</div>

<div vocab="http://schema.org/" typeof="MusicGroup">
<h1 property="name">Foo Fighters</h1>
<div property="video" typeof="VideoObject">
  <h2>Video: <span property="name">Interview with the Foo Fighters</span></h2>
  <meta property="duration" content="T1M33S" />
  <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>
</div>
<h2>Songs</h2>
<div property="track" typeof="MusicRecording">
  <span property="name">Rope</span>
  <meta property="url" content ="foo-fighters-rope.html">
  Length: <meta property="duration" content="PT4M5S">4:05 -
  14300 plays
  <div property="interactionStatistic" typeof="http://schema.org/InteractionCounter">
    <meta property="interactionType" content="http://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>
  <meta property="url" content ="foo-fighters-everlong.html">
  Length: <meta property="duration" content="PT6M33S">6:33 -
  11700 plays
  <div property="interactionStatistic" typeof="http://schema.org/InteractionCounter">
    <meta property="interactionType" content="http://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>
<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
<div property="interactionStatistic" typeof="http://schema.org/InteractionCounter">
  <meta property="interactionType" content="http://schema.org/CommentAction" />
  <meta property="userInteractionCount" content="18" />
</div>
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
</div>

<script type="application/ld+json">
{
  "@context": "http://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"
  ],
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "http://schema.org/CommentAction",
    "userInteractionCount": "18"
  },
  "name": "Foo Fighters",
  "track": [{
    "@type": "MusicRecording",
    "audio": "foo-fighters-rope-play.html",
    "duration": "PT4M5S",
    "inAlbum": "foo-fighters-wasting-light.html",
    "interactionStatistic": {
      "@type": "InteractionCounter",
      "interactionType": "http://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": "http://schema.org/ListenAction",
      "userInteractionCount": "11700"
    },
    "offers": "foo-fighters-everlong-buy.html",
    "url": "foo-fighters-everlong.html"
  }],
  "video": {
    "@type": "VideoObject",
    "description": "Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.",
    "duration": "T1M33S",
    "name": "Interview with the Foo Fighters",
    "thumbnail": "foo-fighters-interview-thumb.jpg"
  }
}
</script>
Example 2
Without Markup Microdata RDFa JSON-LD 
<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>

<div itemscope itemtype="http://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="mp3" />
 <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>

<div vocab="http://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="mp3" />
 <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>

<script type="application/ld+json">
{
  "@context": "http://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": "mp3",
  "name": "12oclock_girona.mp3"
}
</script>

Schema Version 3.2