From cb4d268834b0da0473789f7cb8fb83a46243cca0 Mon Sep 17 00:00:00 2001
From: pany <939630029@qq.com>
Date: Sat, 17 Aug 2024 10:10:56 +0800
Subject: [PATCH] docs(Calendar): improve FQA (#13062)

---
 packages/vant/src/calendar/README.md       | 32 ++++++++++++++++++++++
 packages/vant/src/calendar/README.zh-CN.md |  2 ++
 2 files changed, 34 insertions(+)

diff --git a/packages/vant/src/calendar/README.md b/packages/vant/src/calendar/README.md
index f47452db6..40e22de82 100644
--- a/packages/vant/src/calendar/README.md
+++ b/packages/vant/src/calendar/README.md
@@ -431,3 +431,35 @@ The component provides the following CSS variables, which can be used to customi
 | --van-calendar-day-disabled-color | _var(--van-text-color-3)_ | - |
 | --van-calendar-confirm-button-height | _36px_ | - |
 | --van-calendar-confirm-button-margin | _7px 0_ | - |
+
+## FAQ
+
+### How to use asynchronously returned data in the 'formatter'?
+
+If you need to use asynchronously returned data in a 'formatter', you can dynamically create a 'formatter' function using computed properties, as shown in the following example:
+
+```js
+const asyncData = ref();
+
+const formatter = computed(() => {
+  if (!asyncData.value) {
+    return (day) => day;
+  }
+  return (day) => {
+    day.bottomInfo = asyncData.value;
+    return day;
+  };
+});
+
+setTimeout(() => {
+  asyncData.value = 'text';
+}, 3000);
+```
+
+### Failed to initialize components on iOS system?
+
+If you encounter an issue where components cannot be rendered on iOS, please confirm that you did not use the `new Date ('2020-01-01')` notation when creating the Date object. iOS does not support date formats separated by a dash. The correct notation is `new Date ('2020/01/01')`.
+
+Detailed explanation of this issue: [stackoverflow](https://stackoverflow.com/questions/13363673/javascript-date-is-invalid-on-ios).
+
+Alternatively, you should adopt a more compatible writing style across different systems and browsers: `new Date (2020, 0, 1)`, but it should be noted that the month starts from 0.
diff --git a/packages/vant/src/calendar/README.zh-CN.md b/packages/vant/src/calendar/README.zh-CN.md
index 88730fd5b..8438172d8 100644
--- a/packages/vant/src/calendar/README.zh-CN.md
+++ b/packages/vant/src/calendar/README.zh-CN.md
@@ -467,3 +467,5 @@ setTimeout(() => {
 如果你遇到了在 iOS 上无法渲染组件的问题，请确认在创建 Date 对象时没有使用`new Date('2020-01-01')`这样的写法，iOS 不支持以中划线分隔的日期格式，正确写法是`new Date('2020/01/01')`。
 
 对此问题的详细解释：[stackoverflow](https://stackoverflow.com/questions/13363673/javascript-date-is-invalid-on-ios)。
+
+或者，你应该采用一种在各个系统和浏览器上兼容性更好的写法：`new Date(2020, 0, 1)`，但是需要注意的是，月份是从 0 开始的。