DateTime
A Schema.org Data Type
- Canonical URL: https://schema.org/DateTime
- Check for open issues.
A combination of date and time of day in the form [-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm] (see Chapter 5.4 of ISO 8601).
Instances of
DateTime may appear as a value for the following properties
Property | On Types | Description |
---|---|---|
arrivalTime | Trip | The expected arrival time. |
auditDate | Certification | Date when a certification was last audited. See also gs1:certificationAuditDate. |
availabilityEnds |
ActionAccessSpecification or Demand or Offer |
The end of the availability of the product or service included in the offer. |
availabilityStarts |
ActionAccessSpecification or Demand or Offer |
The beginning of the availability of the product or service included in the offer. |
availableFrom | DeliveryEvent | When the item is available for pickup from the store, locker, etc. |
availableThrough | DeliveryEvent | After this date, the item will no longer be available for pickup. |
bookingTime | Reservation | The date and time the reservation was booked. |
checkinTime |
LodgingBusiness or LodgingReservation |
The earliest someone may check into a lodging establishment. |
checkoutTime |
LodgingBusiness or LodgingReservation |
The latest someone may check out of a lodging establishment. |
commentTime | UserComments | The time at which the UserComment was made. |
contentReferenceTime | CreativeWork | The specific time described by a creative work, for works (e.g. articles, video objects etc.) that emphasise a particular moment within an Event. |
coverageEndTime | LiveBlogPosting | The time when the live blog will stop covering the Event. Note that coverage may continue after the Event concludes. |
coverageStartTime | LiveBlogPosting | The time when the live blog will begin covering the Event. Note that coverage may begin before the Event's start time. The LiveBlogPosting may also be created before coverage begins. |
cvdCollectionDate | CDCPMDRecord | collectiondate - Date for which patient counts are reported. |
datasetTimeInterval | Dataset | The range of temporal applicability of a dataset, e.g. for a 2011 census dataset, the year 2011 (in ISO 8601 time interval format). |
dateCreated |
CreativeWork or DataFeedItem |
The date on which the CreativeWork was created or the item was added to a DataFeed. |
dateDeleted | DataFeedItem | The datetime the item was removed from the DataFeed. |
dateIssued | Ticket | The date the ticket was issued. |
dateModified |
CreativeWork or DataFeedItem |
The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed. |
datePosted |
CDCPMDRecord or JobPosting or RealEstateListing or SpecialAnnouncement |
Publication date of an online listing. |
datePublished |
Certification or CreativeWork |
Date of first publication or broadcast. For example the date a CreativeWork was broadcast or a Certification was issued. |
dateRead | Message | The date/time at which the message has been read by the recipient if a single recipient exists. |
dateReceived | Message | The date/time the message was received if a single recipient exists. |
dateSent | Message | The date/time at which the message was sent. |
departureTime | Trip | The expected departure time. |
doorTime | Event | The time admission will commence. |
dropoffTime | RentalCarReservation | When a rental car can be dropped off. |
endDate |
CreativeWorkSeason or CreativeWorkSeries or DatedMoneySpecification or EducationalOccupationalProgram or Event or MerchantReturnPolicySeasonalOverride or Role or Schedule |
The end date and time of the item (in ISO 8601 date format). |
endTime |
Action or FoodEstablishmentReservation or InteractionCounter or MediaObject or Schedule |
The endTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to end. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the end of a clip within a larger file. Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions. |
exceptDate | Schedule | Defines a Date or DateTime during which a scheduled Event will not take place. The property allows exceptions to a Schedule to be specified. If an exception is specified as a DateTime then only the event that would have started at that specific date and time should be excluded from the schedule. If an exception is specified as a Date then any event that is scheduled for that 24 hour period should be excluded from the schedule. This allows a whole day to be excluded from the schedule without having to itemise every scheduled event. |
expectedArrivalFrom | ParcelDelivery | The earliest date the package may arrive. |
expectedArrivalUntil | ParcelDelivery | The latest date the package may arrive. |
expires |
Certification or CreativeWork |
Date the content expires and is no longer useful or available. For example a VideoObject or NewsArticle whose availability or relevance is time-limited, a ClaimReview fact check whose publisher wants to indicate that it may no longer be relevant (or helpful to highlight) after some date, or a Certification the validity has expired. |
merchantReturnDays |
MerchantReturnPolicy or MerchantReturnPolicySeasonalOverride |
Specifies either a fixed return date or the number of days (from the delivery date) that a product can be returned. Used when the returnPolicyCategory property is specified as MerchantReturnFiniteReturnWindow. |
modifiedTime | Reservation | The date and time the reservation was modified. |
observationDate | Observation | The observationDate of an Observation. |
orderDate | Order | Date order was placed. |
ownedFrom | OwnershipInfo | The date and time of obtaining the product. |
ownedThrough | OwnershipInfo | The date and time of giving up ownership on the product. |
paymentDue |
Invoice or Order |
The date that payment is due. |
paymentDueDate |
Invoice or Order |
The date that payment is due. |
pickupTime |
RentalCarReservation or TaxiReservation |
When a taxi will pick up a passenger or a rental car can be picked up. |
scheduledTime | PlanAction | The time the object is scheduled to. |
startDate |
CreativeWorkSeason or CreativeWorkSeries or DatedMoneySpecification or EducationalOccupationalProgram or Event or MerchantReturnPolicySeasonalOverride or Role or Schedule |
The start date and time of the item (in ISO 8601 date format). |
startTime |
Action or FoodEstablishmentReservation or InteractionCounter or MediaObject or Schedule |
The startTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to start. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the start of a clip within a larger file. Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions. |
temporal | CreativeWork | The "temporal" property can be used in cases where more specific properties (e.g. temporalCoverage, dateCreated, dateModified, datePublished) are not known to be appropriate. |
temporalCoverage | CreativeWork | The temporalCoverage of a CreativeWork indicates the period that the content applies to, i.e. that it describes, either as a DateTime or as a textual string indicating a time period in ISO 8601 time interval format. In
the case of a Dataset it will typically indicate the relevant time period in a precise notation (e.g. for a 2011 census dataset, the year 2011 would be written "2011/2012"). Other forms of content, e.g. ScholarlyArticle, Book, TVSeries or TVEpisode, may indicate their temporalCoverage in broader terms - textually or via well-known URL.
Written works such as books may sometimes have precise temporal coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 interval format format via "1939/1945". Open-ended date ranges can be written with ".." in place of the end date. For example, "2015-11/.." indicates a range beginning in November 2015 and with no specified final date. This is tentative and might be updated in future when ISO 8601 is officially updated. |
uploadDate | MediaObject | Date (including time if available) when this media object was uploaded to this site. |
validFrom |
Certification or Demand or LocationFeatureSpecification or MonetaryAmount or Offer or OpeningHoursSpecification or Permit or PriceSpecification |
The date when the item becomes valid. |
validThrough |
Demand or JobPosting or LocationFeatureSpecification or MonetaryAmount or Offer or OpeningHoursSpecification or PriceSpecification |
The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours. |
webCheckinTime | Flight | The time when a passenger can check into the flight online. |