# TypeScript

URL: https://caijiao.org/dayjs/installation/typescript
Source: docs/dayjs/installation/typescript.md
Description: 在 NPM 包中已经包含 Day.js 的 TypeScript 类型定义文件。 通过 NPM 安装，在 TypeScript 项目中导入并使用。

在 NPM 包中已经包含 [Day.js](/dayjs/) 的 TypeScript 类型定义文件。

通过 NPM 安装

```shell
npm install dayjs
```

在 TypeScript 项目中导入并使用

```javascript
import * as dayjs from "dayjs";
dayjs().format();
```

## 导入 Day.js 遇到了问题？

如果您的 `tsconfig.json` 包含以下配置，您必须使用 `import dayjs from 'dayjs'` 的 default import 模式：

```json
{
  //tsconfig.json
  "compilerOptions": {
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true
  }
}
```

如果您没有上述配置，default import 将无法正常工作。 您需要使用 `import * as dayjs from 'dayjs'`

## 导入本地化语言和插件

在使用本地化语言和插件，您首先需要导入它们。

```javascript
import * as dayjs from "dayjs";
import * as isLeapYear from "dayjs/plugin/isLeapYear"; // 导入插件
import "dayjs/locale/zh-cn"; // 导入本地化语言

dayjs.extend(isLeapYear); // 使用插件
dayjs.locale("zh-cn"); // 使用本地化语言
```