diff --git a/crates/typst-library/src/foundations/datetime.rs b/crates/typst-library/src/foundations/datetime.rs index 2fc48a521..1bcaf3700 100644 --- a/crates/typst-library/src/foundations/datetime.rs +++ b/crates/typst-library/src/foundations/datetime.rs @@ -14,13 +14,11 @@ use crate::foundations::{ }; use crate::World; -/// Represents a date, a time, or a combination of both. +/// 日付、時刻、またはその両方を表します。 /// -/// Can be created by either specifying a custom datetime using this type's -/// constructor function or getting the current date with -/// [`datetime.today`]($datetime.today). +/// この型のコンストラクタ関数を使ってカスタム日時を指定するか、[`datetime.today`]($datetime.today)を使って現在の日付を取得することで作成できます。 /// -/// # Example +/// # 例 /// ```example /// #let date = datetime( /// year: 2020, @@ -45,8 +43,8 @@ use crate::World; /// ) /// ``` /// -/// # Datetime and Duration -/// You can get a [duration] by subtracting two datetime: +/// # DatetimeとDuration +/// 2つのdatetimeの差を取ることで、[duration]を取得できます。 /// ```example /// #let first-of-march = datetime(day: 1, month: 3, year: 2024) /// #let first-of-jan = datetime(day: 1, month: 1, year: 2024) @@ -54,8 +52,7 @@ use crate::World; /// #distance.hours() /// ``` /// -/// You can also add/subtract a datetime and a duration to retrieve a new, -/// offset datetime: +/// datetimeとdurationを加減算することで、新しい日時（オフセットされたdatetime）を取得することもできます。 /// ```example /// #let date = datetime(day: 1, month: 3, year: 2024) /// #let two-days = duration(days: 2) @@ -67,72 +64,43 @@ use crate::World; /// #two-days-later.display() /// ``` /// -/// # Format -/// You can specify a customized formatting using the -/// [`display`]($datetime.display) method. The format of a datetime is -/// specified by providing _components_ with a specified number of _modifiers_. -/// A component represents a certain part of the datetime that you want to -/// display, and with the help of modifiers you can define how you want to -/// display that component. In order to display a component, you wrap the name -/// of the component in square brackets (e.g. `[[year]]` will display the year). -/// In order to add modifiers, you add a space after the component name followed -/// by the name of the modifier, a colon and the value of the modifier (e.g. -/// `[[month repr:short]]` will display the short representation of the month). +/// # フォーマット +/// [`display`]($datetime.display)メソッドを使うことで、日時をカスタマイズして表示するフォーマットを指定できます。日時のフォーマットは、_コンポーネント_ に _修飾子_ を組み合わせることで指定します。 +/// コンポーネントは、日時の中の特定の部分（たとえば年や月など）を表します。そして修飾子を使うことで、そのコンポーネントをどのように表示するかを細かく設定できます。 +/// コンポーネントを表示するには、コンポーネントの名前を角かっこで囲みます（例：`[[year]]`は年を表示します）。修飾子を追加するには、コンポーネント名の後に半角スペースを入れ、修飾子名、コロン（:）、修飾子の値を記述します（例：`[[month repr:short]]`は月名を短縮形で表示します）。 /// -/// The possible combination of components and their respective modifiers is as -/// follows: +/// 使用可能なコンポーネントと修飾子の組み合わせは以下のとおりです。 /// -/// - `year`: Displays the year of the datetime. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// year is padded. -/// - `repr` Can be either `full` in which case the full year is displayed or -/// `last_two` in which case only the last two digits are displayed. -/// - `sign`: Can be either `automatic` or `mandatory`. Specifies when the -/// sign should be displayed. -/// - `month`: Displays the month of the datetime. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// month is padded. -/// - `repr`: Can be either `numerical`, `long` or `short`. Specifies if the -/// month should be displayed as a number or a word. Unfortunately, when -/// choosing the word representation, it can currently only display the -/// English version. In the future, it is planned to support localization. -/// - `day`: Displays the day of the datetime. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// day is padded. -/// - `week_number`: Displays the week number of the datetime. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// week number is padded. -/// - `repr`: Can be either `ISO`, `sunday` or `monday`. In the case of `ISO`, -/// week numbers are between 1 and 53, while the other ones are between 0 -/// and 53. -/// - `weekday`: Displays the weekday of the date. -/// - `repr` Can be either `long`, `short`, `sunday` or `monday`. In the case -/// of `long` and `short`, the corresponding English name will be displayed -/// (same as for the month, other languages are currently not supported). In -/// the case of `sunday` and `monday`, the numerical value will be displayed -/// (assuming Sunday and Monday as the first day of the week, respectively). -/// - `one_indexed`: Can be either `true` or `false`. Defines whether the -/// numerical representation of the week starts with 0 or 1. -/// - `hour`: Displays the hour of the date. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// hour is padded. -/// - `repr`: Can be either `24` or `12`. Changes whether the hour is -/// displayed in the 24-hour or 12-hour format. -/// - `period`: The AM/PM part of the hour -/// - `case`: Can be `lower` to display it in lower case and `upper` to -/// display it in upper case. -/// - `minute`: Displays the minute of the date. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// minute is padded. -/// - `second`: Displays the second of the date. -/// - `padding`: Can be either `zero`, `space` or `none`. Specifies how the -/// second is padded. +/// - `year`: `datetime`の年を表示します。 +/// - `padding`: 年表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `repr`: `full`（4桁表示）`last_two`（2桁表示）を指定できます。 +/// - `sign`: 符号の表示を`automatic`（自動）または`mandatory`（常時）で指定できます。 +/// - `month`: `datetime`の月を表示します +/// - `padding`: 月表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `repr`: 月を数値で表示するか（`numerical`）、英語の月名（`long`）、英語の略称（`short`）で表示するかを指定できます。 +/// 残念ながら、現在のところ、月名表示は英語のみです。将来的にはローカライズが予定されています。 +/// - `day`: `datetime`の日を表示します。 +/// - `padding`: 日表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `week_number`: datetimeの週番号を表示します。 +/// - `padding`: 週番号のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `repr`: `ISO`、`sunday`（日曜開始）、`monday`（月曜開始）を指定できます。ISOの場合、数字は1〜53、それ以外では0〜53で表されます。 +/// - `weekday`: `date`の曜日を表示します。 +/// - `repr`: 曜日名（`long`）、曜日名の略称（`short`）、日曜（`sunday`）、月曜（`monday`）のいずれかを指定できます。 +/// `long`と`short`では、対応する曜日名が英語で表示されます。 +/// （月名と同様に、他言語での表示はまだサポートされていません）。 +/// `sunday`と`monday`では、日曜または月曜から数えた日数が数値で表示されます +/// - `one_indexed`: `true`または`false`を指定できます。これは、曜日の数値表示の際、開始日を0とするか1とするかを指定します。 +/// - `hour`: `date`の時を表示します。 +/// - `padding`: 時表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `repr`: 24時間表示（`24`）または12時間表示（`12`）を指定できます。 +/// - `period`: AM/PM（午前・午後）の表示です。 +/// - `case`: 小文字（`lower`）、大文字（`upper`）を指定できます。 +/// - `minute`: `date`の分を表示します。 +/// - `padding`: 分表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 +/// - `second`: `date`の秒を表示します。 +/// - `padding`: 秒表示のパディングは`zero`（ゼロ）、`space`（空白）、`none`（なし）が指定できます。 /// -/// Keep in mind that not always all components can be used. For example, if you -/// create a new datetime with `{datetime(year: 2023, month: 10, day: 13)}`, it -/// will be stored as a plain date internally, meaning that you cannot use -/// components such as `hour` or `minute`, which would only work on datetimes -/// that have a specified time. +/// すべてのコンポーネントが常に使用できるとは限らない点には注意してください。たとえば、`{datetime(year: 2023, month: 10, day: 13)}`のようにして新しい`datetime`を作成すると、内部的には日付のみが保持されるため、`hour`や`minute`のようなコンポーネントは使用できません。それらは特定の時刻が指定された`datetime`でのみ動作します。 #[ty(scope, cast)] #[derive(Debug, Clone, Copy, PartialEq, Hash)] pub enum Datetime { @@ -233,20 +201,16 @@ impl Datetime { #[scope] impl Datetime { - /// Creates a new datetime. + /// 新しい datetime を作成。 /// - /// You can specify the [datetime] using a year, month, day, hour, minute, - /// and second. + /// 年、月、日、時、分、秒を指定して[datetime]を作成します。 /// - /// _Note_: Depending on which components of the datetime you specify, Typst - /// will store it in one of the following three ways: - /// * If you specify year, month and day, Typst will store just a date. - /// * If you specify hour, minute and second, Typst will store just a time. - /// * If you specify all of year, month, day, hour, minute and second, Typst - /// will store a full datetime. + /// _注_：指定する`datetime`の要素によって、Typstが保持する形式は次の3通りのいずれかになります。 + /// * 年、月、日だけを指定した場合、Typstは日付のみを保持します。 + /// * 時、分、秒だけを指定した場合、Typstは時刻のみを保持します。 + /// * 年、月、日、時、分、秒すべてを指定した場合、Typst は完全な日時を保持します。 /// - /// Depending on how it is stored, the [`display`]($datetime.display) method - /// will choose a different formatting by default. + /// 保持形式に応じて、[`display`]($datetime.display)メソッドはデフォルトで異なるフォーマットを選択します。 /// /// ```example /// #datetime( @@ -257,22 +221,22 @@ impl Datetime { /// ``` #[func(constructor)] pub fn construct( - /// The year of the datetime. + /// `datetime`の年 #[named] year: Option, - /// The month of the datetime. + /// `datetime`の月 #[named] month: Option, - /// The day of the datetime. + /// `datetime`の日 #[named] day: Option, - /// The hour of the datetime. + /// `datetime`の時 #[named] hour: Option, - /// The minute of the datetime. + /// `datetime`の分 #[named] minute: Option, - /// The second of the datetime. + /// `datetime`の秒 #[named] second: Option, ) -> StrResult { @@ -310,7 +274,7 @@ impl Datetime { }) } - /// Returns the current date. + /// 現在の日付を取得。 /// /// ```example /// Today's date is @@ -319,8 +283,7 @@ impl Datetime { #[func] pub fn today( engine: &mut Engine, - /// An offset to apply to the current UTC date. If set to `{auto}`, the - /// offset will be the local offset. + /// 現在のUTC日時に適用するオフセットです。`{auto}`に設定した場合は、ローカルのオフセットが適用されます。 #[named] #[default] offset: Smart, @@ -331,19 +294,17 @@ impl Datetime { .ok_or("unable to get the current date")?) } - /// Displays the datetime in a specified format. + /// 指定したフォーマットで`datetime`を表示します。 + /// 日付のみ、時刻のみ、または両方が指定されているかによって、デフォルトのフォーマットは異なります。 + /// 日付のみ指定されている場合は`[[year]-[month]-[day]]`になります。 + /// 時刻のみ指定されている場合は`[[hour]:[minute]:[second]]`になります。 + /// 日時の両方が指定されている場合は`[[year]-[month]-[day] [hour]:[minute]:[second]]`になります。 /// - /// Depending on whether you have defined just a date, a time or both, the - /// default format will be different. If you specified a date, it will be - /// `[[year]-[month]-[day]]`. If you specified a time, it will be - /// `[[hour]:[minute]:[second]]`. In the case of a datetime, it will be - /// `[[year]-[month]-[day] [hour]:[minute]:[second]]`. - /// - /// See the [format syntax]($datetime/#format) for more information. + /// 詳細は[フォーマット構文]($datetime/#format)を参照してください。 #[func] pub fn display( &self, - /// The format used to display the datetime. + /// `datetime`を表示する際に使用するフォーマットです。 #[default] pattern: Smart, ) -> StrResult { @@ -366,7 +327,7 @@ impl Datetime { result.map(EcoString::from).map_err(format_time_format_error) } - /// The year if it was specified, or `{none}` for times without a date. + /// 年を返します。年が指定されていない場合や、日付を持たない時間の場合は`{none}`になります。 #[func] pub fn year(&self) -> Option { match self { @@ -376,7 +337,7 @@ impl Datetime { } } - /// The month if it was specified, or `{none}` for times without a date. + /// 月を返します。日付を持たない時間の場合は`{none}`になります。 #[func] pub fn month(&self) -> Option { match self { @@ -386,7 +347,7 @@ impl Datetime { } } - /// The weekday (counting Monday as 1) or `{none}` for times without a date. + /// （月曜日を1とする）曜日を返します。日付を持たない時間の場合は`{none}`になります。 #[func] pub fn weekday(&self) -> Option { match self { @@ -396,7 +357,7 @@ impl Datetime { } } - /// The day if it was specified, or `{none}` for times without a date. + /// 日を返します。日付を持たない時間の場合は`{none}`になります。 #[func] pub fn day(&self) -> Option { match self { @@ -406,7 +367,7 @@ impl Datetime { } } - /// The hour if it was specified, or `{none}` for dates without a time. + /// 時を返します。時刻を持たない日付の場合は`{none}`になります。 #[func] pub fn hour(&self) -> Option { match self { @@ -416,7 +377,7 @@ impl Datetime { } } - /// The minute if it was specified, or `{none}` for dates without a time. + /// 分を返します。時刻を持たない日付の場合は`{none}`になります。 #[func] pub fn minute(&self) -> Option { match self { @@ -426,7 +387,7 @@ impl Datetime { } } - /// The second if it was specified, or `{none}` for dates without a time. + /// 秒を返します。時刻を持たない日付の場合は`{none}`になります。 #[func] pub fn second(&self) -> Option { match self { @@ -436,7 +397,8 @@ impl Datetime { } } - /// The ordinal (day of the year), or `{none}` for times without a date. + /// 年の通算日（1年の中での通し番号）を返します。 + /// 日付を持たない時刻の場合は `{none}` になります。 #[func] pub fn ordinal(&self) -> Option { match self { diff --git a/website/translation-status.json b/website/translation-status.json index 4c1a15e43..8a6f64e63 100644 --- a/website/translation-status.json +++ b/website/translation-status.json @@ -20,7 +20,7 @@ "/docs/reference/foundations/bytes/": "untranslated", "/docs/reference/foundations/calc/": "untranslated", "/docs/reference/foundations/content/": "untranslated", - "/docs/reference/foundations/datetime/": "untranslated", + "/docs/reference/foundations/datetime/": "translated", "/docs/reference/foundations/decimal/": "untranslated", "/docs/reference/foundations/dictionary/": "untranslated", "/docs/reference/foundations/duration/": "untranslated",