---
title: DateTime - Customer API
description: |
  Represents an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)-encoded date and time string.
  For example, 3:50 pm on September 7, 2019 in the time zone of UTC (Coordinated Universal Time) is
  represented as `"2019-09-07T15:50:00Z`".
api_version: 2025-10
api_name: customer
type: scalar
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/scalars/datetime
  md: https://shopify.dev/docs/api/customer/latest/scalars/datetime.md
---

# Date​Time

scalar

Represents an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)-encoded date and time string. For example, 3:50 pm on September 7, 2019 in the time zone of UTC (Coordinated Universal Time) is represented as `"2019-09-07T15:50:00Z`".

## Map

### Fields with this scalar

* <-|[Checkout.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-createdAt)
* <-|[Company​Address.createdAt](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-createdAt)
* <-|[Company​Address.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-updatedAt)
* <-|[Customer.creationDate](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-creationDate)
* <-|[Draft​Order.createdAt](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-createdAt)
* <-|[Draft​Order.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-updatedAt)
* <-|[Fulfillment.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Fulfillment#field-createdAt)
* <-|[Fulfillment.estimatedDeliveryAt](https://shopify.dev/docs/api/customer/latest/objects/Fulfillment#field-estimatedDeliveryAt)
* <-|[Fulfillment.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/Fulfillment#field-updatedAt)
* <-|[Fulfillment​Event.happenedAt](https://shopify.dev/docs/api/customer/latest/objects/FulfillmentEvent#field-happenedAt)
* <-|[Metafield.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Metafield#field-createdAt)
* <-|[Metafield.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/Metafield#field-updatedAt)
* <-|[Order.cancelledAt](https://shopify.dev/docs/api/customer/latest/objects/Order#field-cancelledAt)
* <-|[Order.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Order#field-createdAt)
* <-|[Order.processedAt](https://shopify.dev/docs/api/customer/latest/objects/Order#field-processedAt)
* <-|[Order.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/Order#field-updatedAt)
* <-|[Order​Agreement.happenedAt](https://shopify.dev/docs/api/customer/latest/objects/OrderAgreement#field-happenedAt)
* <-|[Order​Edit​Agreement.happenedAt](https://shopify.dev/docs/api/customer/latest/objects/OrderEditAgreement#field-happenedAt)
* <-|[Order​Transaction.createdAt](https://shopify.dev/docs/api/customer/latest/objects/OrderTransaction#field-createdAt)
* <-|[Order​Transaction.processedAt](https://shopify.dev/docs/api/customer/latest/objects/OrderTransaction#field-processedAt)
* <-|[Payment​Schedule.completedAt](https://shopify.dev/docs/api/customer/latest/objects/PaymentSchedule#field-completedAt)
* <-|[Payment​Schedule.dueAt](https://shopify.dev/docs/api/customer/latest/objects/PaymentSchedule#field-dueAt)
* <-|[Payment​Terms.nextDueAt](https://shopify.dev/docs/api/customer/latest/objects/PaymentTerms#field-nextDueAt)
* <-|[Refund.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Refund#field-createdAt)
* <-|[Refund.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/Refund#field-updatedAt)
* <-|[Refund​Agreement.happenedAt](https://shopify.dev/docs/api/customer/latest/objects/RefundAgreement#field-happenedAt)
* <-|[Return.closedAt](https://shopify.dev/docs/api/customer/latest/objects/Return#field-closedAt)
* <-|[Return.createdAt](https://shopify.dev/docs/api/customer/latest/objects/Return#field-createdAt)
* <-|[Return.updatedAt](https://shopify.dev/docs/api/customer/latest/objects/Return#field-updatedAt)
* <-|[Return​Agreement.happenedAt](https://shopify.dev/docs/api/customer/latest/objects/ReturnAgreement#field-happenedAt)

### Inputs with this scalar

* [Subscription​Billing​Cycle​Selector.date](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionBillingCycleSelector#field-date)