> For the complete documentation index, see [llms.txt](https://documentation.soulver.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.soulver.app/ja/rifarensu/dates/dates-and-times.md).

# カレンダー計算

カレンダーの日付を数えるのはもうやめましょう！

### 日付への時間の加算または減算

```
6月10日 + 3週間                  | 7月1日
2019年4月1日 − 3ヶ月 5日         | 2018年12月27日

1988年2月12日 + 32年             | 2020年2月12日
2005年5月1日 + 3年2ヶ月3週間     | 2008年7月22日

昨日 - 8週間3日                  | 7月12日
昨日 + 1週間                     | 6月11日
```

### 現在を基準とした日付の取得

```
今日 + 3週間    | 10月1日
現在 − 1ヶ月    | 5月5日

東京 の 3日 前  | 9月7日
```

### 名前付き休日の計算

日付の計算に祝日の名前を使用できます。祝日の名前は英語で入力します。たとえば、`days until Christmas` はクリスマスまでのカウントダウンです。

日付が毎年変わる祝日の場合は、年を指定して日付を検索します。

`Easter 2027` → **2027年3月28日**

**対応する祝日と特別な日**

* **クリスマス：** Christmas Eve、Christmas Day、Boxing Day、Orthodox Christmas
* **復活祭：** Good Friday、Holy Saturday、Easter Sunday、Easter Monday、Orthodox Good Friday、Orthodox Easter
* **新年：** New Year’s Eve、New Year’s Day、Lunar New Year’s Eve、Lunar New Year
* **ラマダン：** Ramadan、End of Ramadan
* **ハヌカ：** Hanukkah、End of Hanukkah
* **その他の日：** Valentine’s Day、Halloween、Thanksgiving、Black Friday

これらの名前は、日付があなたの国の祝日であるかどうかに関係なく、計算に使用できます。

### **2つの日付間の期間を求める**

```
1月10日 - 2月5日                 | 3 週間 5 日

3月3日 から 5月30日 まで         | 2 月 3 週間 6 日

7月15日 以降の 日数              | 57 日
12月25日 までの 日数             | 106 日
3月3日 と 5月30日 の間の 日      | 88 日

1978 to 2021                     | 42 年
```

最後の例には日本語の表記がありません。英語の表記はどの言語でも使えます。

{% hint style="info" %}
時間間隔は、開始日の正午から間隔内の終了日の正午までを計算します。
{% endhint %}

### 週番号（ISO 8601）

```
年の週                  | 36
2021年3月12日 の週番号  | 10
```

### 日付の一部を取得する

年または月内の日付の位置を見つけます。

`2024年3月15日 の日番号` → **75**

`2024年3月15日 の月の日` → **15**

日付を指定しないと、`年の日` と `月の日` は今日を使用します。

### **月または四半期の経過日数**

```
Q3 の 日        | 92 日
2020年2月 の 日 | 29 日
```

### 今年はどれくらい過ぎましたか？

`年 %` と入力すると、今年の経過時間がパーセンテージで表示されます。

現在の月、週、または日に対して `月 %`、`週 %`、または `日 %` を使用することもできます。

### 2つの日付の中間点を見つける

```
3月12日 と 4月5日 の間の中間点 | 3月24日
```

### 日付の書式設定

形式パターンを使用して、日付の表示方法を制御します。

`2023年3月12日 として EEEE, MMM d, yyyy` → **日曜日, 3月 12, 2023**

ここで、`EEEE` は曜日名、`MMM` は月の短縮形、`d` は日、`yyyy` は 4 桁の年を表します。

[NSDateFormatter.com](https://www.nsdateformatter.com) にアクセスして書式記号を学び、独自のパターンを試してください。

## カレンダー計算における曖昧さに関する注意点

**曖昧な月**

日や週とは異なり、月は秒単位で明確に定義されていません。Soulverは、与えられた式に基づいて最も論理的な処理を試みます。うるう年やその他のカレンダーの特異点を考慮するのが得意です:

```
2月28日 + 1ヶ月          | 3月28日
2020年1月31日 + 1ヶ月    | 2020年2月29日
```

**年が指定されていない日付**

年が指定されていない日付は、現在の年または翌年のいずれかを使用する場合があります。

```
# 2019年12月の場合

// 一番近い1月は未来なので、翌年とみなされます
1月12日 + 3週間 | 2020年2月2日

// 11月はまだ最近の過去なので、今年とみなされます
11月1日 - 5日   | 2019年10月27日
```
