NSPersonNameComponentsFormatter

@interface NSPersonNameComponentsFormatter : NSFormatter

Overview 概要

Each locale has its own set of rules and conventions for how personal names are structured and represented. These rules vary widely across different locales in a several ways, including the sort and display order of given and family names, the use of salutations and honorifics, and other concerns related to the grammar, spelling, punctuation, and formatting. About the only thing that is consistent across all locales is that personal names are significant and meaningful. For this reason, names deserve careful and respectful treatment—perhaps more than any other kind of information your app interacts with. 各ロケールは、それ独自のひと揃いの規則と、どのように個人名が構造化され表現されるかに対する慣行を持ちます。それら規則は、異なるロケールに移れば幾つかの点で大きく変動します、それは名と家族名のソートと表示の順序、あいさつ句と敬称の使用、そして文法、綴り方、句読点、および書式設定に関するその他の懸念材料を含んで余す。ほぽ全ロケールに渡って首尾一貫する唯一の事柄は、個人名は重要で意味があるということです。この理由のために、名前は注意深く敬意を持った扱いに値します — おそらくあなたのアプリが交流する他のどんな種類の情報よりも。

Formatters can be configured to represent names in a variety of styles, which are described in detail below. フォーマッタは、名前をさまざまなスタイルで表すように構成設定されることができます、それは詳細に下で記述されます。

• Default (NSPersonNameComponentsFormatterStyleDefault)

• Short (NSPersonNameComponentsFormatterStyleShort)

• Long (NSPersonNameComponentsFormatterStyleLong)

• Abbreviated (NSPersonNameComponentsFormatterStyleAbbreviated)

When determining how to represent a name in a particular style, a formatter takes a number of factors into consideration, in order of priority: 名前を特定のスタイルにおいてどのように表すかを決定している場合、フォーマッタはいくつかの因子を、以下の優先度の順で考慮に入れます：

1. Script derived behaviors Scripts may specify a strict sort or display order of given and family names, and the availability of styles. 書体から引き出される挙動 書体は、名および苗字の厳密ソートまたは表示順、そしてスタイルの利用可能性を指定するかもしれません。

2. User specified preferences Users can enable and configure the display of short names, as well as whether or not to display nicknames when available. Users can also override the default sort and display order of given and family names for their current locale. ユーザ指定の環境設定 ユーザは短い名前の表示を可能におよび構成設定できます、利用可能な場合にニックネームを表示するかどうかだけでなく。ユーザはまた、名および苗字のそれらの現在のロケールに対する省略時のソートおよび表示の順序をオーバーライドできます。

3. Locale derived defaults Locales specify a default sort and display order for given and family names. ロケールから引き出される初期状態 ロケールは名と苗字に対する省略時のソートおよび表示の順序を指定します。

4. Developer specified configuration The style property value set for the NSPersonNameComponentsFormatter object. 開発者指定の構成設定 NSPersonNameComponentsFormatterオブジェクトに設定されるスタイルプロパティ値。

When the behavior specified in one factor conflicts with any other factors, the behavior specified by the factor with the most precedence is used. ある因子において指定された挙動が何か他の因子と衝突する場合、最も高い優先度をもつ因子によって指定された挙動が使用されます。 For example, the U.S. English (en-US) locale specifies that names be displayed in “given name followed by the family name” (for example,“John Appleseed”). This behavior would be overridden if the user changed their system preferences to have names displayed as family name followed by given name (for example, “Appleseed, John”), because user-specified preferences take precedence over locale-derived defaults. Furthermore, if the name to be formatted were Japanese (for example, given name: “泰夫”, family name: “木田”), the behavior derived for the name’s script (CJK, for Chinese, Japanese, and Korean languages) would take precedence over any locale-derived defaults or user-specified preferences to have the name displayed as family name followed by given name (for example, “木田 泰夫”). この挙動は、もしユーザが彼らのシステム環境設定を変更して名前の表示を苗字に名が続くようにしたならばオーバーライドされるでしょう（例えば、“Appleseed, John”）、なぜならユーザ指定の環境設定はロケール由来の初期設定に優先するからです。さらに、書式設定される名前が日本語だったならば（例えば、名：“泰夫”、苗字：“木田”）、名前のもつ書体（中国語、日本語、そして朝鮮語に対するCJK）に対して導き出される挙動は、あらゆるロケール由来の初期設定またはユーザ指定の環境設定より優先して名前の表示を苗字に名が続くようにするでしょう（例えば、“木田 泰夫”）。

These considerations extend to the availability of certain formatter styles as well. Because developer-specified configurations have the lowest precedence in determining behavior, the value set for the formatter’s style property can be invalidated if it’s not supported for the locale, user preferences, or script. If the specified style is not available, the next longest valid style is used. For example, a name in Arabic script (for example, “أحمد الراجحي”) does not support the Abbreviated style, so the Short style is used instead. これらの配慮は、特定のフォーマッタスタイルの利用可能性にも同様に及びます。開発者指定の構成設定が最も低い優先度を挙動の決定において持つことから、フォーマッタのもつスタイルプロパティに対する値ひとそろいは、それがロケール、ユーザ環境設定、または書体にサポートされないならば無効にされます。指定されたスタイルが利用可能でないならば、次に長い有効なスタイルが使われます。例えば、Arabic書体におけるある名前（例えば、“أحمد الراجحي”）は、「Abbreviated（省略）」スタイルをサポートしません、それで「Short（短い）」スタイルが代わりに使われます。

Styles スタイル

NSPersonNameComponentsFormatter can be configured to format names in the following styles: NSPersonNameComponentsFormatterは、以下のスタイルで名前を書式設定するように構成設定されることができます：

NSPersonNameComponentsFormatterStyleDefault

The minimally necessary features for differentiation in a casual setting. Equivalent to NSPersonNameComponentsFormatterStyleMedium. ふだんの設定における識別のために最小限必要な機能性。NSPersonNameComponentsFormatterStyleMediumに相当します。

NSPersonNameComponentsFormatterStyleShort

Relies on user preferences and language defaults to display shortened form appropriate for display in space-constrained settings. ユーザ環境設定と言語初期値を当てにして、空間抑制設定における表示に適切な短縮形を表示します。

NSPersonNameComponentsFormatterStyleLong

The fully qualified name complete with all known components. 全ての既知の構成要素が備わっている完全修飾名。

NSPersonNameComponentsFormatterStyleAbbreviated

The maximally abbreviated form of a name. ある名前の最大限に省略された形式。

	namePrefix	givenName	middleName	familyName	nameSuffix	nickname ニックネーム
Arabic (ar-SA)	.د	أحمد		محمدالمصري
Chinese (zh-Hans)	物理学博士	振宁		杨	先生
English (en-US)	Dr.	Jonathan	Maple	Appleseed	Esq.	Johnny
French (fr-FR)	Père	Jean-Philippe		de Zélicourt		JP
German (de-DE)	Dr. med.	Max		Mustermann	junior, M.A.
Hindi (hi-IN)	डॉ.	रिय		साहिल
Japanese (ja-JP)		泰夫		木田	先生
Spanish (es-ES)	Dr.	José Ramiro		Martín González de Rivera	júnior, PhD	Ramiro
Thai (th-TH)	ฯพณฯ	สมชาย	ปีเตอร์	รัตนเรืองรองบวรทิพย์

Default

The Default, or Medium, style presents names in a way that is suitable for most contexts. It uses the given and family names, as well as a nickname, if provided and enabled by the user in System Preferences. Default（初期状態）、またはMedium（中）スタイルは、名前を、最も文脈に適する方法で提示します。それは名および苗字を使います、それだけでなくニックネームも、もしユーザによってシステム環境設定において提供されて利用可能にされるならば。

	Default style
Arabic (ar-SA)	أحمد محمﺩﺍلمصﺭﻱ
Chinese (zh-Hans)	杨振宁
English (en-US)	Jonathan Appleseed
French (fr-FR)	Jean-Philippe de Zélicourt
German (de-DE)	Max Mustermann
Hindi (hi-IN)	रिय साहिल
Japanese (ja-JP)	木田泰夫
Spanish (es-ES)	José Ramiro Martín González de Rivera
Thai (th-TH)	สมชาย รัตนเรืองรอง บวรทิพย์

Short

The Short style offers an alternative display method for names whose default representation may exceed a certain length constraint. It is only available if the user has enabled “Short Names” in System Preferences, and only for names with a script that supports Short style. Otherwise, a formatter configured to display with Short style is displayed with Medium style instead. Short（短）スタイルは、ある代替の表示方法を、省略時の表現が特定の長さ制約を超えるかもしれない名前に対して提案します。それは、ユーザが “Short Names” をシステム環境設定において有効にする場合にのみ、そしてShortスタイルをサポートする書体を持つ名前に対してのみ利用可能です。そうでなければ、Shortスタイルで表示するよう構成設定されるフォーマッタは代わりにMediumスタイルで表示されます。

If a user has enabled the use of short names, the user can choose from one of four variations: あるユーザがショートネームの利用を可能にするならば、そのユーザは４つの異体の１つから選べます：

• Given Name - Family Initial 名 - 姓頭文字

• Family Name - Given Initial 姓 - 名頭文字

• Given Name Only 名だけ

• Family Name Only 姓だけ

Short style is not available for names in CJK script and is restricted to Given Name Only or Family Name Only for names in Arabic or Devanagari script. If the specified Short style is unavailable, the Medium style is used instead. Shortスタイルは、CJK書体での名前に対しては利用可能でありません、そしてアラビア語またはデーヴァナーガリー書体での名前に対しては「名のみ」または「姓のみ」に制限されます。指定されたShortスタイルが利用可能でないならば、Mediumスタイルが代わりに使われます。

	Given Name - Family Initial 名 - 姓頭文字	Family Name - Given Initial 姓 - 名頭文字	Given Name Only 名だけ	Family Name Only 姓だけ
Arabic (ar-SA)	N/A	N/A	أحمد	محمﺩﺍلمصﺭﻱ
Chinese (zh-Hans)	N/A	N/A	N/A	N/A
English (en-US)	Jonathan A	J Appleseed	Jonathan	Appleseed
French (fr-FR)	Jean-Philippe d	J de Zélicourt	Jean-Philippe	de Zélicourt
German (de-DE)	Max M	M Mustermann	Max	Mustermann
Hindi (hi-IN)	N/A	N/A	रिय	साहिल
Japanese (ja-JP)	N/A	N/A	N/A	N/A
Spanish (es-ES)	José Ramiro M	J Martín González de Rivera	José Ramiro	Martín González de Rivera
Thai (th-TH)	สมชาย ร	ส รัตนเรืองรองบวรทิพย์	สมชาย	รัตนเรืองรองบวรทิพย์

Long

The Long style provides the most explicit representation of names. It uses all available name components, with the exception of nickname. Long（長）スタイルは、名前の最も率直な表現を提供します。それはすべての利用可能な名前構成要素を使います、ニックネームを除いて。

	Long style
Arabic (ar-SA)	ﺩ. أحمد محمﺩﺍلمصﺭﻱ
Chinese (zh-Hans)	物理学博士杨振宁先生
English (en-US)	Dr. Jonathan Maple Appleseed Esq.
French (fr-FR)	Père Jean-Philippe de Zélicourt
German (de-DE)	Dr. med. Max Mustermann junior, M.A.
Hindi (hi-IN)	डॉ. रिय साहिल
Japanese (ja-JP)	木田泰夫先生
Spanish (es-ES)	Dr. José Ramiro Martín González de Rivera júnior, PhD
Thai (th-TH)	ฯพณฯ สมชาย ปีเตอร์ รัตนเรืองรอง บวรทิพย์

Abbreviated

The Abbreviated style offers the most compact representation of names, similar to a monogram. Abbreviated（省略）スタイルは、モノグラムのような、名前の最も簡潔な表現を提案します。

Abbreviated style is supported for names in several scripts, with the following general characteristics: Abbreviatedスタイルは、いくつかの書体での名前によってサポートされます、以下の一般的な特徴を持ちます：

• For names in Cyrillic, Greek, or Latin script, the first characters of givenName, middleName, and familyName may be used. キリル語、ギリシャ語、またはラテン語書体での名前に対して、givenName、middleName、そしてfamilyNameの最初の表意文字が使われるかもしれません。

• For names in Chinese or Japanese script, familyName may be used. If familyName is too long, or if the family name is nil, the Short or Medium style may be used instead. 中国語または日本語書体での名前に対して、familyNameが使われるかもしれません。familyNameが長すぎるならば、または姓がnilならば、ShortまたはMediumスタイルが代わりに使われるかもしれません。

• For names in Korean script, givenName may be used. If givenName is too long, the first character of givenName may be used. If givenName is nil, the familyName may be used instead. 朝鮮語書体での名前に対して、givenNameが使われるかもしれません。givenNameが長すぎるならば、givenNameの最初の表意文字が使われるかもしれません。givenNameがnilならば、familyNameが代わりに使われるかもしれません。

• For names in Bengali, Devanagari, Gujarati, Gurmukhi, Kannada, Malayalam, Oriya, Sinhala, Tamil, Telugu, Tibetan, or Thai script, the first character of givenName may be used. If givenName is nil, the first character of familyName may be used instead. ベンガル語、デーヴァナーガリー、グジャラート語、グルムキー文字、カンナダ語、マラヤーラム語、オリヤー語、シンハラ語、タミル語、テルグ語、チベット語、またはタイ語書体での名前に対して、givenNameの最初の表意文字が使われるかもしれません。givenNameがnilならば、familyNameの最初の表意文字が代わりに使われるかもしれません。

• For names that contain more than one script, the abbreviated style may use the familyName, givenName, or the first characters of givenName and/or familyName. １つ以上の書体を含む名前に対して、省略されたスタイルはfamilyName、givenNameを、またはgivenNameおよび／またはfamilyNameの最初の表意文字を使うかもしれません。

If the Abbreviated style is unavailable, the Short style is used instead—unless that too is unsupported, in which case the Medium style is used instead. Abbreviatedスタイルが利用可能でないならば、Shortスタイルが代わりに使われます — それがまたサポートされない場合を除いて、その場合にはMediumスタイルが代わりに使われます。

	Abbreviated style
Arabic (ar-SA)	N/A
Chinese (zh-Hans)	杨
English (en-US)	JMA
French (fr-FR)	Jd
German (de-DE)	MM
Hindi (hi-IN)	मि
Japanese (ja-JP)	木田
Spanish (es-ES)	JM
Thai (th-TH)	ส