# **TODATE**

返回日期对象。

该函数是将日期字符串按照指定的日期格式转换成日期对象，如果没有指定日期格式，那么默认按照`yyyyMMdd hh:mm:ss`的格式进行转换。**formatString**区分大小写，月份需要大写。

## 语法{#grammar}

TODATE(**dateString**, **formatString**)

- **dateString**：日期字符串
- **formatString**：可选，日期格式字符串。默认格式为 "yyyyMMdd hh:mm:ss"

## 示例{#example}

1. `TODATE("20120409 04:04:03","yyyyMMdd")` 日期字符串，返回`20120409 00:00:00`
2. `TODATE("20120409 04:04:03")` 毫秒值，返回`20120409 04:04:03`
3. `TODATE('20120409','yyyyMMdd')` 年月日，返回`20120409`
4. `TODATE('201204','yyyyMM')` 年月，返回`201204`
5. `TODATE('2012','yyyy')"` 年，返回`2012`

## 详细描述{#description}

| 格式                 | 示例                            |
| ---------------------| ------------------------------ |
| Y M D | 年 月 日 |
| H m S | 时 分 秒 |
| yyyy | 2012 |
| yyyy年 | 2012年 |
| yyyyMM | 201204 |
| yyyy-MM | 2012-04 |
| yyyy年MM月 | 2012年04月 |
| yyyyMMdd | 20120409 |
| yyyy-MM-dd | 2012-04-09 |
| yyyy年MM月dd日 | 2012年04月09日 |
| yyyyMMdd HH:mm:ss | 20120409 04:04:03 |