Go to home page for the PBCore



Go to home page for PBCore

Go to User Guide

 

PBCore in Use

PBCore ELEMENTS
Help


01.00 
01.01
01.02

02.00 
02.01
02.02

03.00
03.01
03.02

04.00
04.01
04.02

05.00
05.01
05.02

06.00
06.01
06.02

07.00
07.01
07.02

08.00
08.01

09.00
09.01



15.00
15.01
15.02

16.00
16.01
16.02

17.00
17.01
17.02

18.00
18.00



25.00
25.01 
25.02
25.03
25.04
25.05
25.06
25.07
25.08
25.09
25.10
25.11
25.12
25.13
25.14
25.15
25.16
25.17
25.18
25.19
25.20
25.21
25.22
25.23

25.24
25.24.1
25.24.2

25.25
25.25.1
25.25.2

25.26
25.26.1



99.00
99.01
99.02

Go to PBCore User Guide
Go to PBCore Element Cheat Sheet
Go to Examples of PBCore Metadata
Go to Explanation of Element Attributes
Go to Case Examples of PBCore Implementations
Go to the PBCore XML Schema (XSD)
Provide Feedback

 
25.02
dateIssued

Describe this Element
Show Me Examples
Other Attributes of this Element

Describe this Element


NAME
Help

dateIssued

DEFINITION
Help

The descriptor dateIssued specifies the formal date for a particular version or rendition of a media item has been made ready or officially released for distribution, publication or consumption. A specific time may also be associated with the date if such granularity is helpful.

ELEMENT
INTERDEPENDENCIES

Info on element interdependencies

Element Interdependency This element is hierarchically bound to the container pbcoreInstantiation


REFINEMENTS &
ENCODING SCHEMES

Help  

Where and if appropriate, you may decide to use the specific date/time encoding rules established in the ISO 8601 profile of the international standard for the representation of dates and times:
(http://www.w3.org/TR/NOTE-datetime)
(http://www.w3.org/TR/xmlschema-2/#dateTime).

However, PBCore has determined that the pure ISO 8601 Profile and its current strict representational requirements in XML Schema Definitions are too restrictive.

PBCore recommends that you employ the syntax ISO 8601 suggests for entering dates (e.g., YYYY-MM-DD), but by no means is the entire Date+Time string required as you enter a date or time stamp for your media item. The date and/or time designated is essentially an open-ended text string with highly recommended syntax for entering years, months, and days. Examples are provided below.


GUIDELINES
FOR USAGE

Help

The descriptor dateIssued refers to the date for a particular version or rendition of a media item that has been officially released or issued for consumption, publication or distribution. It is likely a date later than the creation date indicated in dateCreated. A specific time may also be associated with the date.

Do not confuse dateIssued with the dates and times indicated in the descriptor coverage and its companion element coverageType when it equals "Temporal." A date of issue refers to the release date for consumption of a particular rendition of a media item. The information for the descriptor coverage when it is of coverageType "Temporal" describes the time-bound identifiers for the intellectual content found within a media item, e.g., a photograph of the aftermath on the attack on Pearl Harbor might have a date of issue of December 15, 1941 (1941-12-15), but an intellectual content time stamp (coverage) of December 7, 1941 (1941-12-07).

DATE FORMATTING:

PBCore recommends that you employ the syntax ISO 8601 suggests for entering dates (e.g., YYYY-MM-DD), but by no means is the entire Date+Time string required as you enter a date or time stamp for your media item. The date and/or time designated is essentially an open-ended text string with highly recommended syntax for entering years, months, and days.

The recommended format consists of a text string for the representation of dates YYYY-MM-DD (1998-01-24).

  • Year (YYYY) is defined as 0000 to 9999.
  • Month (MM) is defined as 01 to 12.
  • Day (DD) is defined as 01 to 28, 29, 30 or 31 as applicable.
  • The separator between date fields is a hyphen, (-).

If the full date is unknown, month and year (YYYY-MM) or just year (YYYY) may be used. Many other syntaxes are possible, but if used, they may not be easily interpreted, searchable, or shareable.

If a date is approximate, add a question mark but separate the date from the question mark by a space so that the question mark is not interpreted as part of the date value by a search engine, e.g., 1922 ? . Generally, a year or year-month-day designation will provide enough precision.

If needed, a specific time stamp may directly follow the date designation. The time stamp can be enclosed within parentheses. The time format (hh:mm:ss) consists of two digit designations for hours, minutes and seconds (19:20:30) in a 24 hour clock mode. If necessary, the seconds may be further defined by a decimal fraction of a second (19:20:30.45).

ISO 8601 requests the inclusion of a time zone designator (TZD) to complete a date/time statement, but PBCore does not require or mandate that specification.


OBLIGATION
TO USE

Help

Optional

REPEATABLE
ELEMENT

Help

Apply once within its container, pbcoreInstantiation (which itself can be applied multiple times for each rendition of a media item)

TYPE OF
DATA ENTRY

Help

Text String


Go to Top of Page

 

Show Me Examples
Help


Year:
YYYY
1997

Year and month:
YYYY-MM
1997-07

Complete date:
YYYY-MM-DD
1997-07-16

Complete date with a 24 hour clock time stamp with seconds precision:
YYYY-MM-DD (hh:mm:ss)
1997-07-16 (16:30:00)

Complete date with a 24 hour clock time stamp with decimal fraction precision:
YYYY-MM-DD (hh:mm:ss.df)
1997-07-16 (16:30:00.34)

Approximate year
1998 ?

Complete ISO 8601 compliant date plus hours and minutes with Time Zone:
YYYY-MM-DDThh:mmTZD
1997-07-16T19:20+01:00

Complete ISO 8601 date plus hours, minutes and seconds with Time Zone:
YYYY-MM-DDThh:mm:ssTZD
1997-07-16T19:20:30+01:00

Complete ISO 8601 date plus hours, minutes, seconds and a decimal fraction of a second with Time Zone:
YYYY-MM-DDThh:mm:ss.sTZD
1997-07-16T19:20:30.45+01:00

Go to Case Studies of PBCore Applications

Go to Top of Page

 

Other Attributes of this Element


ELEMENT
LABEL

Help

dateIssued

ELEMENT
VERSION

Help

PBCore v1.1

NAMESPACE
IDENTIFIER

Help

Public Broadcasting Metadata Dictionary Project Namespace
http://www.pbcore.org/PBCore/PBCoreNamespace.html

REGISTRATION
AUTHORITY

Help

PBMD Project [pending]

LANGUAGE
OF THE
ELEMENT

Help

eng


Go to Top of Page

 

 
 
 
 

 

PBCore in Use

 

Go to CPB website

© 2005 Corporation for Public Broadcasting
- CPB Privacy Policy -
- PBCore Licensing via Creative Commons -