DateTime

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

DataType > DateTime

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).

Usage: Between 10 and 100 domains


Instances of DateTime may appear as values for the following properties

PropertyOn TypesDescription
arrivalTime BusTrip  or
Flight  or
TrainTrip 
The expected arrival time.
availabilityEnds Demand  or
Offer 
The end of the availability of the product or service included in the offer.
availabilityStarts 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.
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.
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.
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 BusTrip  or
Flight  or
TrainTrip 
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
Event  or
Role 
The end date and time of the item (in ISO 8601 date format).
endTime Action  or
FoodEstablishmentReservation 
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.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.

expectedArrivalFrom ParcelDelivery The earliest date the package may arrive.
expectedArrivalUntil ParcelDelivery The latest date the package may arrive.
modifiedTime Reservation The date and time the reservation was modified.
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.
paymentDueDate Invoice  or
Order 
The date that payment is due. Supersedes paymentDue.
pickupTime RentalCarReservation  or
TaxiReservation 
When a taxi will pickup 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
Event  or
Role 
The start date and time of the item (in ISO 8601 date format).
startTime Action  or
FoodEstablishmentReservation 
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.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.

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". Supersedes datasetTimeInterval.
validFrom 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.

Schema Version 3.2