本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Quick 中自定义日期格式
<a name="format-visual-date-controls"></a>

在 Quick 中，您可以在筛选器和参数控件中自定义日期的格式设置。例如，您可以指定将控件中的日期格式设置为 20-09-2021 或 09-20-2021。除其他自定义设置外，您还可以指定将日期中的月份（例如 September）缩短为三个字母（Sep）。

以下是可用于创建自定义日期格式的标记列表。您能以组合方式使用这些符号，控制日期在控件中的显示方式。

## 支持设置日期格式的标记列表
<a name="format-date-supported-tokens"></a>

使用以下标记在 Quick 中自定义日期格式。


| 示例 | 说明 | 令牌 | 
| --- | --- | --- | 
| 0–6 | 用数字表示一周中的某一天。0 表示星期日，6 表示星期六。 | `d` | 
| Mo–Su | 用 2 个字符的文本表示一周中的某一天。 | `dd` | 
| Mon–Sun | 用 3 个字符的文本表示一周中的某一天。 | `ddd` | 
| Monday–Sunday | 用文本表示一周中的某一天。 | `dddd` | 
| 99 或 21 | 用 2 位数表示年份。 | `YY` | 
| 1999 或 2021 | 用 4 位数字完整表示年份。 | `YYYY` | 
| 1–12 | 表示月份，前面不带 0。 | `M` | 
| 1st、2nd 到 12th | 表示月份，前面不带 0 但带有序数后缀。 | `Mo` | 
| 01–12 | 表示月份，前面带 0。 | `MM` | 
| Jan–Dec | 用 3 位数文本表示月份。 | `MMM` | 
| January–December | 用文本完整表示月份。 | `MMMM` | 
| 1–4 | 用数字表示季度。 | `Q` | 
| 1st–4th | 用带有序数后缀的数字表示季度。 | `Qo` | 
| 1-31 | 表示月份中的某一天，前面不带 0。 | `D` | 
| 1st、2nd 到 31st | 表示月份中的某一天，前面不带 0 但带有序数后缀。 | `Do` | 
| 01–31 | 用 2 位数表示月份中的某一天，前面带 0。 | `DD` | 
| 1–365 | 表示一年中的某一天，前面不带 0。 | `DDD` | 
| 001–365 | 表示一年中的某一天，前面带 0。 | `DDDD` | 
| 1–53 | 表示一年中的某一周，前面不带 0。 | `w` | 
| 1st–53rd | 表示一年中的某一周，前面不带 0 但带有序数后缀。 | `wo` | 
| 01–53rd | 表示一年中的某一周，前面带 0。 | `ww` | 
| 1–23 | 表示小时，采用 24 小时制，前面不带 0。 | `H` | 
| 01–23 | 表示小时，采用 24 小时制，前面带 0。 | `HH` | 
| 1–12 | 表示小时，采用 12 小时制，前面不带 0。 | `h` | 
| 01–12 | 表示小时，采用 12 小时制，前面带 0。 | `hh` | 
| 0-59 | 表示分钟，前面不带 0。 | `m` | 
| 00–59 | 表示分钟，前面带 0。 | `mm` | 
| 0-59 | 表示秒数，前面不带 0。 | `s` | 
| 00–59 | 表示秒数，前面带 0。 | `ss` | 
| am 或 pm | am/pm | `a` | 
| AM 或 PM | AM/PM | `A` | 
| 1632184215 | 表示 Unix 时间戳。 | `X` | 
| 1632184215000 | 表示毫秒 Unix 时间戳。 | `x` | 
| Z | 零 UTC 偏移。 | `Z` | 

不支持以下日期类型。
+ 带冒号的时区偏差。例如，\+07:00。
+ 不带冒号的时区偏差。例如，\+0730。

### 预设日期格式
<a name="visuals-preset-date-formats"></a>

要快速自定义显示为以下示例格式之一的日期和时间，您可以使用以下 Quick 预设标记。


| 示例 | 令牌 | 
| --- | --- | 
| 8:30 PM | `LT` | 
| 8:30:25 PM | `LTS` | 
| August 2 1985 | `LL` | 
| Aug 2 1985 | `ll` | 
| August 2 1985 08:30 PM | `LLL` | 
| Aug 2 1985 08:30 PM | `lll` | 
| Thursday, August 2 1985 08:30 PM | `LLLL` | 
| Thu, Aug 2 1985 08:30 PM | `llll` | 

## 常见日期格式
<a name="visuals-common-date-formats"></a>

以下是三个常见的日期示例及其相关的标记格式，供您快速参考。


| 示例 | 标记格式 | 
| --- | --- | 
| Sep 20, 2021 | `MMM DD, YYYY` | 
| 20-09-21 5pm | `DD-MM-YY ha` | 
| Monday, September 20, 2021 17:30:15 | `dddd, MMMM DD, YYYY HH:mm:ss` | 

## 在日期中添加单词
<a name="visuals-adding-words-to-dates"></a>

要在日期格式中包含单词，例如 *20th of Sep, 2021* 中的“of”一词，请在单词中的每个字符前输入反斜杠（\\）。例如，对于“20th of Sep, 2021”日期示例，请使用以下标记格式：`Do \o\f MMM, YYYY`。

## 示例：在筛选条件控件中自定义日期格式
<a name="format-visual-date-controls-example"></a>

要了解如何使用日期标记格式为筛选条件控件自定义日期，请按照以下过程操作。

**了解使用数据标记为筛选条件控件自定义日期**

1. 在快速分析中，选择要自定义的筛选控件。

1. 在筛选条件控件上，选择**编辑控件**图标。

1. 在打开的**编辑控件**页面上，在**日期格式**中输入所需的自定义日期格式。使用在本主题前文中列出的标记。

   例如，假设您想使用以下格式自定义日期：*Sep 3rd, 2020 at 5pm*。为此，您可以输入以下标记格式：

   `MMM Do, YYYY \a\t ha`

   输入每个标记时，日期格式的预览效果会显示在输入字段下方。

1. 选择**应用**。

   控件中的日期会更新为您指定的格式。