> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Internationalized Time Zone Capability

> YiDA now supports internationalized time zones, letting overseas users display time based on their device's time zone. Both single overseas time zone scenarios and cross-time zone collaboration scenarios are supported, covering system time and form date fields. Ideal for cross-border work, project management, international trade, and more.

<Note>
  * Available on YiDA China edition, Professional edition (overseas), and Dedicated edition (overseas)
  * Available on YiDA international edition with the "Internationalization" capability included
</Note>

### Overview

YiDA now supports internationalized time zones. Users in overseas time zones can view system time and form time fields based on their own device's time zone.

* Single overseas time zone scenario: Both YiDA system time and form date field time are displayed in the current device's time zone.

* Cross-time zone collaboration scenario

## Time Zone Date Component

### Feature Overview

The **Time Zone Date** component adds a **Time Zone** attribute on top of the [Date component](/yida/form/alex84), ensuring the consistency and accuracy of time fields for users across different time zones in cross-time zone collaboration scenarios.

### Use Cases

* Cross-border work and project management: Helps team members in different regions view and confirm meeting times.
* International trade: Clearly displays shipment time, arrival time, payment collection time, and more.

## Effect

### How to Use

#### Configure the Time Zone Date Field in a Form

Follow these steps to configure the Time Zone Date component.

1. Sign in to the YiDA workbench.

<Note>
  Overseas users, sign in to the [YiDA international edition](https://www.yidaApps.com).
</Note>

<Steps>
  <Step title="Step 1">
    Install the **Internationalized Time Zone Component** from the YiDA **Plugin Center**.
  </Step>

  <Step title="Step 2">
    Open the **Page Editor** of the app, select the target page, and click **Edit Form**.
  </Step>
</Steps>

<Steps>
  <Step title="Go to Component > Basic components > Common > Time Zone Date" />

  <Step title="Configure the following settings in the Attribute panel on the right" />
</Steps>

| **Setting**                     | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Component basic information** | Basic component information includes the title, placeholder, description, status, validation, and more. See [Component basic information](/yida/form/snftao) for details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Default time and time zone**  | Default refers to the value shown when a user opens the form. The Time Zone Date component supports three configuration methods:<br />• Custom: Configure the time zone default with the following options.<br /><br />• Data linkage: See [Data linkage](/yida/form/arpur0).<br />• Quick setup: Currently, quick setup only supports setting the time based on the Respondent's device time zone.                                                                                                                                                                                                                                                         |
| **Format**                      | The following five time formats are supported:<br />• Year<br />• Year-Month<br />• Year-Month-Day<br />• Year-Month-Day Hour:Minute<br />• Year-Month-Day Hour:Minute:Second<br />**Note**: For the formats **Year**, **Year-Month**, and **Year-Month-Day**, the time field is not offset by time zone across environments (the time is displayed as submitted). For **Year-Month-Day Hour:Minute** and **Year-Month-Day Hour:Minute:Second**, you can choose whether to enable **Automatically convert to device time zone time**. Example: If the Submitter is in GMT+8 and submits at 2025-01-14 18:00:00, a viewer in GMT-8 sees 2025-01-13 02:00:00. |
| **Show time zone**              | When turned off, the time zone is not displayed on the data management page or Source records page.<br />(The time zone cannot be hidden on the form submission page.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Layout**                      | Two layouts are supported:<br />• Horizontal: Time zone on the left, date on the right.<br />• Vertical: Time zone on top, date on the bottom.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

5. After configuration, click **Preview** at the top to view the result.

#### Configure the Time Zone Time Field in Reports

In reports, you can select the following time zone information fields from a Time Zone Date field: the city corresponding to the time zone, the GMT offset of the time zone, and the date time zone text.

Set the format of the **Time Zone Date Text** field as needed.

#### Use the Time Zone Date Field

The Time Zone Date component is supported on the Source records page, data list page, import and export, print, custom pages, and reports.

## FAQ

#### 1. After Adding a "Time Zone Date" Field to a Form, How Do I Batch Assign the Values from the Existing "Date" Field to the New "Time Zone Date" Field?

Migrate the data by exporting and then update-importing, in five steps:

1. Batch export the form data. Be sure to select the option to export the instance ID, which serves as the matching field for the subsequent update import.

2. Populate the new field values in Excel in bulk (copy the old field values to the new field and add time zone information).

3. Bulk edit any one legacy field in the form.

This step upgrades existing data to the new form version. Because the existing data does not contain the newly added "Time Zone Date" field, a direct update will fail. Use the **Bulk Edit** feature to upgrade the form version of the existing data.

The **Bulk Edit** feature is located at: App Management > Form > Data Management > More > Bulk Edit. See [Bulk Edit feature guide](/yida/form/ne8htk).

4. Update-import the data from the Excel file back into the current form.
