# generaltranslation: General Translation Core SDK: formatRelativeTimeFromDate
URL: https://generaltranslation.com/ja/docs/core/class/methods/formatting/format-relative-time-from-date.mdx
---
title: formatRelativeTimeFromDate
description: Date からの相対時間を形式化するための formatRelativeTimeFromDate メソッドの API リファレンス
---

## 概要

`formatRelativeTimeFromDate` メソッドは、`Date` から相対時間の文字列を生成し、最も適切な単位を自動的に選択します。

```typescript
const gt = new GT();
const pastDate = new Date(Date.now() - 7200000); // 2時間前
const formatted = gt.formatRelativeTimeFromDate(pastDate, {
  locales: 'en-US'
});
// 戻り値: "2 hours ago"
```


## リファレンス

### パラメータ

| 名前         | 型        | 説明                          |
| ---------- | -------- | --------------------------- |
| `date`     | `Date`   | `baseDate` を基準に相対的に形式設定する日付 |
| `options?` | `object` | 形式設定に関する設定                  |

### オプション

| 名前               | 型                               | 説明                                                |
| ---------------- | ------------------------------- | ------------------------------------------------- |
| `locales?`       | `string \| string[]`            | 形式設定に使用するロケール。指定しない場合は、インスタンスのレンダリング時のロケールが使用されます |
| `baseDate?`      | `Date`                          | 比較の基準となる日付。デフォルトは `new Date()` です                 |
| `numeric?`       | `'always' \| 'auto'`            | 常に数値による出力を使用するかどうか。デフォルトは `'auto'` です             |
| `style?`         | `'long' \| 'short' \| 'narrow'` | 出力の長さ。デフォルトは `'long'` です                          |
| `localeMatcher?` | `'best fit' \| 'lookup'`        | 使用するロケール一致アルゴリズム                                  |

### 戻り値

`string` - 形式設定された相対時間の文字列 (例: 「2時間前」「3日後」) 。

***

## 例

```typescript copy
import { GT } from 'generaltranslation';
const gt = new GT();

const now = new Date();

// 自動的に "hours" を選択
const twoHoursAgo = new Date(now.getTime() - 7200000);
gt.formatRelativeTimeFromDate(twoHoursAgo, { locales: 'en-US', baseDate: now });
// 戻り値: "2 hours ago"

// 自動的に "days" を選択
const threeDaysLater = new Date(now.getTime() + 259200000);
gt.formatRelativeTimeFromDate(threeDaysLater, { locales: 'fr-FR', baseDate: now });
// 戻り値: "dans 3 jours"
```

***

## 注意事項

* 時間差に応じて最適な単位を自動的に選択します
* デフォルトでは `numeric: 'auto'` と `style: 'long'` が使用されます
* `baseDate` が指定されていない場合、デフォルトは `new Date()` です

## 次のステップ

* 値と単位を明示して形式設定するには、[`formatRelativeTime`](/docs/core/class/methods/formatting/format-relative-time) を参照してください
* GT インスタンスを作成せずに使用する場合は、スタンドアロンの [`formatRelativeTimeFromDate`](/docs/core/functions/formatting/format-relative-time-from-date) 関数を参照してください