⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/DateTime. Если сайт оказался полезен, то можете пожертвовать 50 рублей создателями сайта.

DateTime

Тип данных schema.org ?

Содержание: Описание, Подходит для свойств.

DateTime

Описание:

Комбинация даты и времени суток в формате [-]ГГГГ-ММ-ДДTчч:мм:сс[Z|(+|-)чч:мм] (см. главу 5.4 ISO 8601).

Тип данных DateTime в Schema.org представляет собой комбинацию даты и времени. Он используется для представления конкретных моментов во времени, что позволяет структурировать и стандартизировать информацию о событиях, сроках или других временных аспектах.

Основная цель использования DateTime заключается в том, чтобы обеспечить однозначное и понятное представление временных данных. Это особенно важно для веб-страниц и приложений, где информация может быть интерпретирована различными системами или пользователями. Стандартизированный формат, такой как ISO 8601, позволяет избежать путаницы, связанной с различными форматами даты и времени, которые могут существовать в разных странах или культурах.

DateTime часто применяется в контексте описания событий, таких как мероприятия, публикации или изменения статуса. Он позволяет указать точное время начала и окончания события или срок действия информации. Это делает данные более полезными и доступными для поиска, фильтрации и анализа.

Использование DateTime в Schema.org также способствует улучшению семантической разметки веб-страниц, что может повысить их видимость в поисковых системах и улучшить взаимодействие с пользователями, предоставляя четкую и структурированную информацию о времени.

Экземпляры DateTime могут использоваться в качестве значения для следующих свойств.

Свойство Типы Описание
arrivalTime Trip Ожидаемое время прибытия.
auditDate Certification Дата, когда сертификация была последний раз проверена. См. также gs1:certificationAuditDate.
availabilityEnds Demand, ActionAccessSpecification, Offer Конец доступности продукта или услуги, включенного в предложение.
availabilityStarts Offer, Demand, ActionAccessSpecification Начало доступности продукта или услуги, включенного в предложение.
availableFrom DeliveryEvent Когда товар доступен для получения из магазина, шкафа для хранения и т.д.
availableThrough DeliveryEvent После этой даты товар больше не будет доступен для получения.
bookingTime Reservation Дата и время, когда была забронирована резервация.
checkinTime LodgingReservation, LodgingBusiness Самое раннее время, когда кто-либо может зарегистрироваться в гостиничном заведении.
checkoutTime LodgingReservation, LodgingBusiness Последний срок, когда кто-либо может выехать из заведения размещения.
commentTime Время, в которое был оставлен комментарий пользователя.
contentReferenceTime CreativeWork Конкретное время, описанное творческим произведением, для произведений (например, статей, видео и т.д.), которые подчеркивают определенный момент в рамках События.
coverageEndTime LiveBlogPosting Время, когда живой блог прекратит освещение события. Обратите внимание, что освещение может продолжаться и после завершения события.
coverageStartTime LiveBlogPosting Время, когда живой блог начнет освещать событие. Обратите внимание, что освещение может начаться до времени начала события. Живой блог может также быть создан до начала освещения.
cvdCollectionDate CDCPMDRecord датаСбора - Дата, за которую сообщается количество пациентов.
datasetTimeInterval Dataset Диапазон временной применимости набора данных, например, для набора данных переписи населения 2011 года — это год 2011 (в формате временного интервала ISO 8601).
dateCreated DataFeedItem, CreativeWork Дата, на которую была создана творческая работа или элемент был добавлен в DataFeed.
dateDeleted DataFeedItem Дата и время, когда элемент был удален из DataFeed.
dateIssued Ticket Дата, когда билет был выдан.
dateModified CreativeWork, DataFeedItem Дата, когда произведение было в последний раз изменено или когда запись элемента была изменена в рамках DataFeed.
datePosted SpecialAnnouncement, RealEstateListing, JobPosting, CDCPMDRecord Дата публикации онлайн-объявления.
datePublished CreativeWork, Certification Дата первой публикации или трансляции. Например, дата, когда Творческое произведение было транслировано или Сертификация была выдана.
dateRead Message Дата/время, когда сообщение было прочитано получателем, если существует единственный получатель.
dateReceived Message Дата/время, когда сообщение было получено, если существует единственный получатель.
dateSent Message Дата/время, когда сообщение было отправлено.
departureTime Trip Ожидаемое время отправления.
doorTime Event Время начала допуска.
dropoffTime RentalCarReservation Время, когда можно вернуть арендованный автомобиль.
endDate Schedule, Role, MerchantReturnPolicySeasonalOverride, Event, EducationalOccupationalProgram, CreativeWorkSeries, CreativeWorkSeason Дата и время окончания элемента (в формате даты ISO 8601).
endTime Action, MediaObject, FoodEstablishmentReservation, Schedule, InteractionCounter Время окончания чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) — время, когда ожидается его завершение. Для действий, которые занимают определенный период времени, это время выполнения действия. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение конца клипа в рамках более крупного файла.

Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже когда описываются даты с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
exceptDate Schedule Определяет Date или DateTime, в течение которого запланированное Event не будет проводиться. Свойство позволяет указать исключения из Schedule. Если исключение указано как DateTime, то только событие, которое должно было начаться в эту конкретную дату и время, должно быть исключено из расписания. Если исключение указано как Date, то любое событие, запланированное на этот 24-часовой период, должно быть исключено из расписания. Это позволяет исключить целый день из расписания, не перечисляя каждое запланированное событие.
expectedArrivalFrom ParcelDelivery Самая ранняя дата, когда посылка может прибыть.
expectedArrivalUntil ParcelDelivery Последняя дата, когда посылка может прибыть.
expires CreativeWork, Certification Дата, когда контент истекает и больше не является полезным или доступным. Например, VideoObject или NewsArticle, чья доступность или актуальность ограничена по времени, ClaimReview факт-чекинг, чей издатель хочет указать, что он может больше не быть актуальным (или полезным для выделения) после определенной даты, или Certification, срок действия которого истек.
merchantReturnDays MerchantReturnPolicySeasonalOverride, MerchantReturnPolicy Указывает либо фиксированную дату возврата, либо количество дней (с даты доставки), в течение которых продукт может быть возвращен. Используется, когда свойство returnPolicyCategory указано как MerchantReturnFiniteReturnWindow.
modifiedTime Reservation Дата и время, когда бронь была изменена.
observationDate Observation Дата наблюдения Наблюдения.
orderDate Order Дата, когда был размещен заказ.
ownedFrom OwnershipInfo Дата и время получения продукта.
ownedThrough OwnershipInfo Дата и время передачи права собственности на продукт.
paymentDue Order, Invoice Дата, когда платеж должен быть произведен.
paymentDueDate Order, Invoice Дата, когда платеж должен быть произведен.
pickupTime TaxiReservation, RentalCarReservation Когда такси заберет пассажира или когда можно забрать арендованный автомобиль.
scheduledTime PlanAction Время, на которое запланирован объект.
startDate CreativeWorkSeason, CreativeWorkSeries, MerchantReturnPolicySeasonalOverride, EducationalOccupationalProgram, Role, Schedule, Event Дата и время начала элемента (в формате даты ISO 8601).
startTime Schedule, MediaObject, InteractionCounter, FoodEstablishmentReservation, Action Время начала чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) это время, когда ожидается его начало. Для действий, которые занимают определенный период времени, это время, когда действие было выполнено. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение начала клипа в рамках большего файла.

Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже при описании дат с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
temporal CreativeWork Свойство "temporal" может использоваться в случаях, когда более специфические свойства (например, temporalCoverage, dateCreated, dateModified, datePublished) не известны как подходящие.
temporalCoverage CreativeWork Свойство temporalCoverage у CreativeWork указывает период, к которому относится содержимое, то есть который оно описывает, либо в формате DateTime, либо в текстовой строке, указывающей временной промежуток в формате временных интервалов ISO 8601. В случае набора данных (Dataset) он обычно указывает соответствующий временной период в точной нотации (например, для набора данных переписи 2011 года год 2011 будет записан как "2011/2012"). Другие формы содержимого, например, ScholarlyArticle, Book, TVSeries или TVEpisode, могут указывать свой temporalCoverage более широкими терминами - текстово или через известный URL. Письменные произведения, такие как книги, также могут иметь точное временное покрытие, например, произведение, действие которого происходит в 1939 - 1945 годах, может быть указано в формате интервала ISO 8601 как "1939/1945".

Неопределенные диапазоны дат могут быть записаны с использованием ".." вместо конечной даты. Например, "2015-11/.." указывает диапазон, начинающийся в ноябре 2015 года и без указанной конечной даты. Это предварительно и может быть обновлено в будущем, когда ISO 8601 будет официально обновлен.
uploadDate MediaObject Дата (включая время, если доступно), когда этот медиаобъект был загружен на этот сайт.
validFrom PriceSpecification, Permit, OpeningHoursSpecification, Offer, MonetaryAmount, LocationFeatureSpecification, Demand, Certification Дата, когда объект становится действительным.
validThrough PriceSpecification, OpeningHoursSpecification, Offer, MonetaryAmount, LocationFeatureSpecification, JobPosting, Demand Дата, после которой элемент становится недействительным. Например, конец предложения, период зарплаты или период рабочих часов.
webCheckinTime Flight Время, когда пассажир может зарегистрироваться на рейс онлайн.
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте