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 FinancialIncentive or LocationFeatureSpecification or MonetaryAmount or Offer or OpeningHoursSpecification or Permit or PriceSpecification |
The date when the item becomes valid. |
| validThrough |
Demand or FinancialIncentive 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. |