chore(release): release 22.0.0-beta.0 (#9870)

Author: Laffery

CHANGELOG.md

@@ -1,12 +1,21 @@
-## [22.0.0-alpha.0](https://github.com/NG-ZORRO/ng-zorro-antd/compare/21.3.2...22.0.0-alpha.1) (2026-06-12)
+## [22.0.0-beta.0](https://github.com/NG-ZORRO/ng-zorro-antd/compare/21.3.2...22.0.0-beta.0) (2026-07-13)
 
-- Support Angular v22
-- All components use OnPush change detection strategy
+### Features
+
+- All components use OnPush change detection strategy ([#9824](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9824)) ([b50ea34](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b50ea34e298ff153f1809b96ca3d4c0a6d8b9082))
+- **\*:** add date adapter support ([#9858](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9858)) ([d578c8b](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d578c8bd619743f7a4c77f092d5d43b8b196e6e2))
+
+### Bug Fixes
 
-> **NOTE**: v22 is still in alpha stage and may contain breaking changes in future releases.
+- **form:** signal form compatibility ([#9831](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9831)) ([f57fd67](https://github.com/NG-ZORRO/ng-zorro-antd/commit/f57fd67fd49b3b274a8b8e54de22f230b82624da))
+- **i18n:** add missing translations to `ja_JP` ([#9857](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9857)) ([1ff499e](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1ff499e511b2f10d444ed9e050d0beea9433a166))
 
 ### ⚠ BREAKING CHANGES
 
+Date-related components no longer provide a default date engine adapter. Applications that use date-related components must configure a date adapter explicitly. To keep the previous date-fns based behavior, add `provideNzDateFnsAdapter()` in `app.config.ts`.
+
+`date-fns` has been upgraded to v4. Applications that use `date-fns` APIs directly should update their imports and date-fns usage to be compatible with v4. ([#9868](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9868)) ([a865a89](https://github.com/NG-ZORRO/ng-zorro-antd/commit/a865a89832e1382dc291c1028c2ae58f47891987))
+
 Remove the following APIs which were marked as deprecated in the previous version:
 
 | Module                        | API                                                                                  |

components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-zorro-antd",
-  "version": "22.0.0-alpha.1",
+  "version": "22.0.0-beta.0",
   "license": "MIT",
   "description": "An enterprise-class UI components based on Ant Design and Angular",
   "schematics": "./schematics/collection.json",

components/version/version.ts

@@ -5,4 +5,4 @@
 
 import { Version } from '@angular/core';
 
-export const VERSION = new Version('22.0.0-alpha.1');
+export const VERSION = new Version('22.0.0-beta.0');

docs/changelog.en-US.md

@@ -16,17 +16,26 @@ tag: '{{version}}'
 
 ---
 
-## 22.0.0-alpha.1
+## 22.0.0-beta.0
 
-`2026-06-12`
+`2026-07-13`
 
-- Support Angular v22
-- All components use OnPush change detection strategy
+### Features
+
+- All components use OnPush change detection strategy ([#9824](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9824)) ([b50ea34](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b50ea34e298ff153f1809b96ca3d4c0a6d8b9082))
+- **\*:** add date adapter support ([#9858](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9858)) ([d578c8b](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d578c8bd619743f7a4c77f092d5d43b8b196e6e2))
+
+### Bug Fixes
 
-> **NOTE**: v22 is still in alpha stage and may contain breaking changes in future releases.
+- **form:** signal form compatibility ([#9831](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9831)) ([f57fd67](https://github.com/NG-ZORRO/ng-zorro-antd/commit/f57fd67fd49b3b274a8b8e54de22f230b82624da))
+- **i18n:** add missing translations to `ja_JP` ([#9857](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9857)) ([1ff499e](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1ff499e511b2f10d444ed9e050d0beea9433a166))
 
 ### ⚠ BREAKING CHANGES
 
+Date-related components no longer provide a default date engine adapter. Applications that use date-related components must configure a date adapter explicitly. To keep the previous date-fns based behavior, add `provideNzDateFnsAdapter()` in `app.config.ts`.
+
+`date-fns` has been upgraded to v4. Applications that use `date-fns` APIs directly should update their imports and date-fns usage to be compatible with v4. ([#9868](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9868)) ([a865a89](https://github.com/NG-ZORRO/ng-zorro-antd/commit/a865a89832e1382dc291c1028c2ae58f47891987))
+
 Remove the following APIs which were marked as deprecated in the previous version:
 
 | Module                        | API                                                                                  |

docs/changelog.zh-CN.md

@@ -16,17 +16,26 @@ tag: '{{version}}'
 
 ---
 
-## 22.0.0-alpha.1
+## 22.0.0-beta.0
 
-`2026-06-12`
+`2026-07-13`
 
-- 支持 Angular v22
-- 所有组件均使用 OnPush
+### Features
+
+- 所有组件均使用 OnPush ([#9824](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9824)) ([b50ea34](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b50ea34e298ff153f1809b96ca3d4c0a6d8b9082))
+- **\*:** 新增日期适配器支持 ([#9858](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9858)) ([d578c8b](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d578c8bd619743f7a4c77f092d5d43b8b196e6e2))
+
+### Bug Fixes
 
-> **注意**: v22 仍然处于预览阶段，未来版本可能会包含破坏性变更。
+- **form:** 修复 signal form 兼容性问题 ([#9831](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9831)) ([f57fd67](https://github.com/NG-ZORRO/ng-zorro-antd/commit/f57fd67fd49b3b274a8b8e54de22f230b82624da))
+- **i18n:** 补充 `ja_JP` 缺失翻译 ([#9857](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9857)) ([1ff499e](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1ff499e511b2f10d444ed9e050d0beea9433a166))
 
 ### ⚠ BREAKING CHANGES
 
+日期相关组件不再内置默认日期引擎适配器。使用日期相关组件的应用需要在应用配置中显式提供日期适配器；如需保持旧版本基于 date-fns 的行为，可在 `app.config.ts` 中配置 `provideNzDateFnsAdapter()`。
+
+`date-fns` 已升级至 v4。直接使用 `date-fns` API 的应用需要更新 import 和相关用法，以兼容 v4 版本。([#9868](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9868)) ([a865a89](https://github.com/NG-ZORRO/ng-zorro-antd/commit/a865a89832e1382dc291c1028c2ae58f47891987))
+
 移除以下在过去的版本中标记为废弃的 API:
 
 | Module                        | API                                                                                  |

docs/migration-v22.en-US.md

@@ -28,3 +28,20 @@ This document will help you upgrade from `ng-zorro-antd` 21.x version to 22.x ve
 ### 3. Remove deprecated APIs
 
 - Remove deprecated APIs, please refer to the [v22 changelog](/docs/changelog/en#2200) for more information.
+
+### 4. Configure date adapter
+
+NG-ZORRO no longer provides a default date engine adapter. If your application uses date-related components such as DatePicker, Calendar, or TimePicker, configure a date adapter explicitly in `app.config.ts`.
+
+To keep the previous date-fns based behavior:
+
+```ts
+import { ApplicationConfig } from '@angular/core';
+import { provideNzDateFnsAdapter } from 'ng-zorro-antd/core/time';
+
+export const appConfig: ApplicationConfig = {
+  providers: [provideNzDateFnsAdapter()]
+};
+```
+
+`date-fns` has been upgraded to v4. If your application uses `date-fns` APIs directly, update the imports and date-fns usage to be compatible with v4.

docs/migration-v22.zh-CN.md

@@ -28,3 +28,20 @@ toc: false
 ### 3. 移除废弃 API
 
 - 请参考 [v22 changelog](/docs/changelog/zh#2200) 移除废弃 API
+
+### 4. 配置日期适配器
+
+NG-ZORRO 不再内置默认日期引擎适配器。如果你的应用使用 DatePicker、Calendar、TimePicker 等日期相关组件，需要在 `app.config.ts` 中显式配置日期适配器。
+
+如需保持旧版本基于 date-fns 的行为：
+
+```ts
+import { ApplicationConfig } from '@angular/core';
+import { provideNzDateFnsAdapter } from 'ng-zorro-antd/core/time';
+
+export const appConfig: ApplicationConfig = {
+  providers: [provideNzDateFnsAdapter()]
+};
+```
+
+`date-fns` 已升级至 v4。如果你的应用直接使用 `date-fns` API，请同步更新 import 和相关用法以兼容 v4。