---
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-01
api_name: customer
type: scalar
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-01/scalars/DateTime'
  md: 'https://shopify.dev/docs/api/customer/2025-01/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/2025-01/objects/Checkout#field-Checkout.fields.createdAt)
* <-|[Company​Address.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/CompanyAddress#field-CompanyAddress.fields.createdAt)
* <-|[Company​Address.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/CompanyAddress#field-CompanyAddress.fields.updatedAt)
* <-|[Customer.creationDate](https://shopify.dev/docs/api/customer/2025-01/objects/Customer#field-Customer.fields.creationDate)
* <-|[Draft​Order.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/DraftOrder#field-DraftOrder.fields.createdAt)
* <-|[Draft​Order.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/DraftOrder#field-DraftOrder.fields.updatedAt)
* <-|[Fulfillment.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/Fulfillment#field-Fulfillment.fields.createdAt)
* <-|[Fulfillment.estimatedDeliveryAt](https://shopify.dev/docs/api/customer/2025-01/objects/Fulfillment#field-Fulfillment.fields.estimatedDeliveryAt)
* <-|[Fulfillment.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/Fulfillment#field-Fulfillment.fields.updatedAt)
* <-|[Fulfillment​Event.happenedAt](https://shopify.dev/docs/api/customer/2025-01/objects/FulfillmentEvent#field-FulfillmentEvent.fields.happenedAt)
* <-|[Metafield.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/Metafield#field-Metafield.fields.createdAt)
* <-|[Metafield.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/Metafield#field-Metafield.fields.updatedAt)
* <-|[Order.cancelledAt](https://shopify.dev/docs/api/customer/2025-01/objects/Order#field-Order.fields.cancelledAt)
* <-|[Order.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/Order#field-Order.fields.createdAt)
* <-|[Order.processedAt](https://shopify.dev/docs/api/customer/2025-01/objects/Order#field-Order.fields.processedAt)
* <-|[Order.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/Order#field-Order.fields.updatedAt)
* <-|[Order​Agreement.happenedAt](https://shopify.dev/docs/api/customer/2025-01/objects/OrderAgreement#field-OrderAgreement.fields.happenedAt)
* <-|[Order​Edit​Agreement.happenedAt](https://shopify.dev/docs/api/customer/2025-01/objects/OrderEditAgreement#field-OrderEditAgreement.fields.happenedAt)
* <-|[Order​Transaction.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/OrderTransaction#field-OrderTransaction.fields.createdAt)
* <-|[Order​Transaction.processedAt](https://shopify.dev/docs/api/customer/2025-01/objects/OrderTransaction#field-OrderTransaction.fields.processedAt)
* <-|[Payment​Schedule.completedAt](https://shopify.dev/docs/api/customer/2025-01/objects/PaymentSchedule#field-PaymentSchedule.fields.completedAt)
* <-|[Payment​Schedule.dueAt](https://shopify.dev/docs/api/customer/2025-01/objects/PaymentSchedule#field-PaymentSchedule.fields.dueAt)
* <-|[Payment​Terms.nextDueAt](https://shopify.dev/docs/api/customer/2025-01/objects/PaymentTerms#field-PaymentTerms.fields.nextDueAt)
* <-|[Refund.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/Refund#field-Refund.fields.createdAt)
* <-|[Refund.updatedAt](https://shopify.dev/docs/api/customer/2025-01/objects/Refund#field-Refund.fields.updatedAt)
* <-|[Refund​Agreement.happenedAt](https://shopify.dev/docs/api/customer/2025-01/objects/RefundAgreement#field-RefundAgreement.fields.happenedAt)
* <-|[Return​Agreement.happenedAt](https://shopify.dev/docs/api/customer/2025-01/objects/ReturnAgreement#field-ReturnAgreement.fields.happenedAt)
* <-|[Store​Credit​Account​Credit​Transaction.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/StoreCreditAccountCreditTransaction#field-StoreCreditAccountCreditTransaction.fields.createdAt)
* <-|[Store​Credit​Account​Credit​Transaction.expiresAt](https://shopify.dev/docs/api/customer/2025-01/objects/StoreCreditAccountCreditTransaction#field-StoreCreditAccountCreditTransaction.fields.expiresAt)
* <-|[Store​Credit​Account​Debit​Revert​Transaction.createdAt](https://shopify.dev/docs/api/customer/2025-01/objects/StoreCreditAccountDebitRevertTransaction#field-StoreCreditAccountDebitRevertTransaction.fields.createdAt)

### Inputs with this scalar

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