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

### Inputs with this scalar

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