styles.numbers【表示形式】モジュール
メモ ( 概要 基本 組み込み表示形式・定数 ) 定数 参考:Excel 組み込み表示形式 (抜粋) 参考:書式記号 関数 例
クラス: NumberFormat【表示形式 (内部使用)】 NumberFormatDescriptor【表示形式ディスクリプタ】 NumberFormatList【表示形式リスト (内部使用)】
メモ
概要
- Cell【セル】の表示形式に関連するモジュール
- Excelの [セルの書式設定]-[表示形式]タブ に対応
- Excelの [セルの書式設定]-[表示形式]タブ に対応
- モジュール内定義
- インポート
- 下記は、openpyxl.styles からインポート可
NumberFormatDescriptor【表示形式ディスクリプタ】クラス
is_builtin【組み込み表示形式チェック】関数
is_date_format【日付表示形式チェック】関数
- 下記は、openpyxl.styles からインポート可
- その他スタイルは、cell【セル】モジュール 参照 (個々の詳細は下記モジュール)
- styles.alignment【配置】 ・styles.fonts【フォント】 ・styles.borders【罫線】 ・styles.fills【塗りつぶし】 ・styles.protection【シート保護】
- 関連モジュール
基本
〔 例 〕- Cell【セル】 の number_format【表示形式】プロパティに表示形式 (文字列) を指定
- 表示形式は下記参照
定数:表示形式
参考:Excel 組み込み表示形式 (抜粋)
参考:書式記号
- 表示形式は下記参照
- 一部日本語未対応の為、同等の表記を指定
未対応 対応 備考 G/標準 General 書式記号の標準 参照 [色 (日本語)]
例:[赤][色 (英語)]
例:[Red]書式記号の色・比較条件の指定 参照 - 複数セル一括設定
- 一括設定不可の為、単一セル毎に設定 ( worksheet【ワークシート】モジュール の セルの参照 参照)
組み込み表示形式・定数
〔 例:定数 〕〔 例:関数 〕- 汎用的な表示形式は、インデックス・定数で定義
- builtin_format_code【組み込み表示形式 取得】でインデックスから取得
- ロケールに関係する表示形式は一部なので、個別に指定
外部リンク
- openpyxl (英語)
- ECMA-376:Office Open XML file formats (英語)
SpreadsheetML:- numFmt (Number Format)
- numFmts (Number Formats)
- numFmt (Number Format)
- Microsoft Office
定数
表示形式
id:builtin_format_code【組み込み表示形式 取得】のインデックス (実体は、BUILTIN_FORMATS で定義)
id | 定数 | 表示形式 (区切りで補正) | 備考 |
---|---|---|---|
0 | FORMAT_GENERAL | General | G/標準 |
1 | FORMAT_NUMBER | 0 | 数値 |
2 | FORMAT_NUMBER_00 | 0.00 | 数値 (小数点以下2桁) |
3 | #,##0 | 数値 (3桁区切り) | |
4 | FORMAT_NUMBER_COMMA_SEPARATED1 | #,##0.00 | 数値 (3桁区切り・小数点以下2桁) |
5 | ・ロケール対応 (プレースホルダ) "$"#,##0_); ("$"#,##0) ・Excel 読み込み時 ¥#,##0; ¥-#,##0 | ・プレースホルダ 通貨 (ドル記号・3桁区切り) (負数:カッコ) ・日本語 通貨 (円記号・3桁区切り) (負数:通貨記号の後にマイナス記号) | |
6 | ・ロケール対応 (プレースホルダ) "$"#,##0_); [Red]("$"#,##0) ・Excel 読み込み時 ¥#,##0; [赤]¥-#,##0 | ・プレースホルダ 通貨 (ドル記号・3桁区切り) (負数:赤色カッコ) ・日本語 通貨 (円記号・3桁区切り) (負数:赤色・通貨記号の後にマイナス記号) | |
7 | ・ロケール対応 (プレースホルダ) "$"#,##0.00_); ("$"#,##0.00) ・Excel 読み込み時 ¥#,##0.00; ¥-#,##0.00 | ・プレースホルダ 通貨 (ドル記号・3桁区切り・小数点以下2桁) (負数:カッコ) ・日本語 通貨 (円記号・3桁区切り・小数点以下2桁) (負数:通貨記号の後にマイナス記号) | |
8 | ・ロケール対応 (プレースホルダ) "$"#,##0.00_); [Red]("$"#,##0.00) ・Excel 読み込み時 ¥#,##0.00; [赤]¥-#,##0.00 | ・プレースホルダ 通貨 (ドル記号・3桁区切り・小数点以下2桁) (負数:赤色カッコ) ・日本語 通貨 (円記号・3桁区切り・小数点以下2桁) (負数:赤色・通貨記号の後にマイナス記号) | |
9 | FORMAT_PERCENTAGE | 0% | パーセンテージ |
10 | FORMAT_PERCENTAGE_00 | 0.00% | パーセンテージ (小数点以下2桁) |
11 | 0.00E+00 | 指数表示 (仮数部:小数点以下2桁) | |
12 | # ?/? | 分数 (分母1桁) | |
13 | # ??/?? | 分数 (分母2桁) | |
14 | FORMAT_DATE_XLSX14 | mm-dd-yy | 年月日 (アメリカ式・年2桁) |
15 | FORMAT_DATE_XLSX15 | d-mmm-yy | 年月日 (イギリス式・年2桁・月:頭3文字) |
16 | FORMAT_DATE_XLSX16 | d-mmm | 月日 (イギリス式・月:頭3文字) |
17 | FORMAT_DATE_XLSX17 | mmm-yy | 年月 (月:頭3文字) |
18 | FORMAT_DATE_TIME1 | h:mm AM/PM | 時分 (12時間表示・午前:AM・午後:PM) |
19 | FORMAT_DATE_TIME2 | h:mm:ss AM/PM | 時分秒 (12時間表示・午前:AM・午後:PM) |
20 | FORMAT_DATE_TIME3 | h:mm | 時分 |
21 | FORMAT_DATE_TIME4 FORMAT_DATE_TIME6 | h:mm:ss | 時分秒 |
22 | FORMAT_DATE_XLSX22 | m/d/yy h:mm | 年月日時分 ((アメリカ式・年2桁・年月日:スラッシュ区切り) |
37 | #,##0_); (#,##0) | 数値 (3桁区切り) (負数:カッコ) | |
38 | #,##0_); [Red](#,##0) | 数値 (3桁区切り) (負数:赤色カッコ) | |
39 | #,##0.00_); (#,##0.00) | 数値 (3桁区切り・小数点以下2桁) (負数:カッコ) | |
40 | #,##0.00_); [Red](#,##0.00) | 数値 (3桁区切り・小数点以下2桁) (負数:赤色カッコ) | |
41 | ・ロケール対応 (プレースホルダ) r'_(* #,##0_); _(* \(#,##0\); _(* "-"_); _(@_)' ・Excel 読み込み時 _ * #,##0_ ; _ * -#,##0_ ; _ * "-"_ ; _ @_ | ・プレースホルダ 数値 (3桁区切り・数値位置合わせ) (負数:カッコ) (ゼロ:-) (テキスト:そのまま) ・日本語 数値 (3桁区切り・両端スペース) (負数:前にマイナス記号) (ゼロ:-) (テキスト:そのまま) | |
42 | ・ロケール対応 (プレースホルダ) r'_("$"* #,##0_); _("$"* \(#,##0\); _("$"* "-"_); _(@_)' ・Excel 読み込み時 _ ¥* #,##0_ ; _ ¥* -#,##0_ ; _ ¥* "-"_ ; _ @_ | ・プレースホルダ 通貨 (ドル記号・3桁区切り・数値位置合わせ) (負数:カッコ) (ゼロ:$ -) (テキスト:そのまま) ・日本語 通貨 (円記号・3桁区切り・数値位置合わせ) (負数:通貨記号の後にマイナス記号) (ゼロ:¥ -) (テキスト:そのまま) | |
43 | ・ロケール対応 (プレースホルダ) r'_(* #,##0.00_); _(* \(#,##0.00\); _(* "-"??_); _(@_)' ・Excel 読み込み時 _ * #,##0.00_ ; _ * -#,##0.00_ ; _ * "-"??_ ; _ @_ | ・プレースホルダ 数値 (3桁区切り・小数点以下2桁・数値位置合わせ) (負数:カッコ) (ゼロ:-) (テキスト:そのまま) ・日本語 数値 (3桁区切り・小数点以下2桁・数値位置合わせ) (負数:前にマイナス記号) (ゼロ:-) (テキスト:そのまま) | |
44 | ・ロケール対応 (プレースホルダ) r'_("$"* #,##0.00_)_("$"* \(#,##0.00\)_("$"* "-"??_)_(@_)' ・Excel 読み込み時 _ ¥* #,##0.00_ ; _ ¥* -#,##0.00_ ; _ ¥* "-"??_ ; _ @_ | ・プレースホルダ 通貨 (ドル記号・3桁区切り・小数点以下2桁・数値位置合わせ) (負数:カッコ) (ゼロ:$ -) (テキスト:そのまま) ・日本語 通貨 (円記号・3桁区切り・小数点以下2桁・数値位置合わせ) (負数:通貨記号の後にマイナス記号) (ゼロ:¥ -) (テキスト:そのまま) | |
45 | FORMAT_DATE_TIME5 | mm:ss | 分秒 |
46 | [h]:mm:ss | 経過時間 (時分秒) | |
47 | mmss.0 | 分秒 (区切りなし・小数点以下1桁) | |
48 | ##0.0E+0 | 指数表示 (仮数部:小数点以下1桁) | |
49 | FORMAT_TEXT | @ | 文字列 |
FORMAT_CURRENCY_EUR_SIMPLE | [$EUR ]#,##0.00_- | 通貨 (EUR・3桁区切り・小数点以下2桁・右端:マイナス記号分空白) | |
FORMAT_CURRENCY_USD | $#,##0_- | 通貨 (ドル記号・3桁区切り・右端:マイナス記号分空白) | |
FORMAT_CURRENCY_USD_SIMPLE | "$"#,##0.00_- | 通貨 (ドル記号・3桁区切り・小数点以下2桁・右端:マイナス記号分空白) | |
FORMAT_DATE_DATETIME | yyyy-mm-dd h:mm:ss | 年月日時分秒 (年月日:ハイフン区切り) | |
FORMAT_DATE_DDMMYY | dd/mm/yy | 年月日 (イギリス式・年2桁・スラッシュ区切り) | |
FORMAT_DATE_DMMINUS | d-m | 月日 (イギリス式・ハイフン区切り) | |
FORMAT_DATE_DMYMINUS | d-m-y | 年月日 (イギリス式・年2桁・ハイフン区切り) | |
FORMAT_DATE_DMYSLASH | d/m/y | 年月日 (イギリス式・年2桁・スラッシュ区切り) | |
FORMAT_DATE_MYMINUS | m-y | 年月 (イギリス式・年2桁・ハイフン区切り) | |
FORMAT_DATE_TIME7 | i:s.S | ||
FORMAT_DATE_TIME8 | h:mm:ss@ | (定義ミス) | |
FORMAT_DATE_TIMEDELTA | [hh]:mm:ss | 経過時間 (時分秒) | |
FORMAT_DATE_YYMMDD | yy-mm-dd | 年月日 (年2桁・ハイフン区切り) | |
FORMAT_DATE_YYMMDDSLASH | yy/mm/dd@ | (定義ミス) | |
FORMAT_DATE_YYYYMMDD2 | yyyy-mm-dd | 年月日 (年4桁・ハイフン区切り) | |
FORMAT_NUMBER_COMMA_SEPARATED2 | #,##0.00_- | 数値 (3桁区切り・小数点以下2桁・右端:マイナス記号分空白) |
参考:Excel 組み込み表示形式 (抜粋)
Excel 組み込み表示形式の確認:定義済の項目を選択し、続けて[ユーザー定義]を選択
分類 | 表示形式 | 備考 | 例 |
---|---|---|---|
数値 | #,##0_ ;[Red]-#,##0(SP) | 数値 (3桁区切り・負数:符号付赤字・右端:空白) | -12,345(SP) |
#,##0;"▲ "#,##0 | 数値 (3桁区切り・マイナス符号:▲) | ▲ 12,345 | |
通貨 | ¥#,##0;[Red]¥-#,##0 | 通貨 (円記号付き・3桁区切り・負数:符号付赤字) | ¥-1,234 |
日付 | yyyy"年"m"月"d"日";@ | 年月日 (西暦年:4桁・区切り:漢字) | 2001年2月3日 |
[$-411]ggge"年"m"月"d"日";@ | 年月日 (和暦年・区切り:漢字) | 令和4年5月6日 | |
その他 | [<=999]000;[<=9999]000-00;000-0000 | 郵便番号 | 123-4567 |
[<=99999999]####-####;(00) ####-#### | 電話番号 | (03) 1234-5678 | |
[DBNum1][$-411]General | 漢数字 | 一万二千三百四十五 | |
[DBNum2][$-411]General | 大字 | 壱萬弐阡参百四拾伍 | |
[DBNum3][$-411]#,##0 | 全角 (3桁区切り) | 12,345 |
参考:書式記号
書式記号 | 備考 | 例 | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
指定方法 | ||||||||||||||||||||||||||||||||||
[色]表示形式 [比較条件]表示形式 [色] [比較条件]表示形式 | 色・比較条件の指定 両方指定する場合は色が先
| |||||||||||||||||||||||||||||||||
全てが対象 正数・ゼロ;負数 正数;負数; ゼロ;テキスト [条件]表示形式 ;表示形式 [条件]表示形式 ; [条件]表示形式 ;表示形式 | 表示形式指定方法 全てが対象全てのセル値の表示形式 正数・ゼロ正数・ゼロの表示形式 正数正数の表示形式 ゼロゼロの表示形式 負数負数の表示形式 テキストテキストの表示形式 条件の区切り:; (セミコロン) 条件色と比較条件の組合せ | |||||||||||||||||||||||||||||||||
特殊記号 | ||||||||||||||||||||||||||||||||||
General | 標準 (未対応:G/標準) | |||||||||||||||||||||||||||||||||
@ | 入力値そのまま表示 (複数条件の最後等に指定) | |||||||||||||||||||||||||||||||||
”文字列” | 文字列表示 | |||||||||||||||||||||||||||||||||
\文字 | 文字表示 (参照:単独表示可能な文字) | |||||||||||||||||||||||||||||||||
(SP) | スペーサー | |||||||||||||||||||||||||||||||||
_文字 (アンダースコア) | スペーサー (文字幅分) | |||||||||||||||||||||||||||||||||
*文字 | 文字埋め込み (セル幅になるまで文字繰り返し) | ###123 | ||||||||||||||||||||||||||||||||
[$-ロケールId] | ロケール指定 | [$-411] | ||||||||||||||||||||||||||||||||
[$通貨コード] | 通貨コード (そのまま表示) | [$JPY]・[$USD]・[$EUR] | ||||||||||||||||||||||||||||||||
[DBNum1] | 漢数字 | 十二万三千四百 | ||||||||||||||||||||||||||||||||
[DBNum2] | 大字 | 壱拾弐萬参阡四百 | ||||||||||||||||||||||||||||||||
[DBNum3] | 全角 | 12345 1万2千3百4十5 | ||||||||||||||||||||||||||||||||
数値 | ||||||||||||||||||||||||||||||||||
# | 1桁の数字 (ゼロサプレス) | '######' ⇒ 123 | ||||||||||||||||||||||||||||||||
0 | 1桁の数字 (ゼロパディング) | '000000' ⇒ 000123 | ||||||||||||||||||||||||||||||||
. (ドット) | 小数点 | |||||||||||||||||||||||||||||||||
? | 小数部・分数のスペーサー | 0.??? | ||||||||||||||||||||||||||||||||
, (カンマ) | 桁区切り 1000 で割った小数部を四捨五入 | |||||||||||||||||||||||||||||||||
E+ E– e+ e– | 指数 | |||||||||||||||||||||||||||||||||
年 | ||||||||||||||||||||||||||||||||||
yy | 西暦 (2桁) | 01 | ||||||||||||||||||||||||||||||||
yyyy | 西暦 (4桁) | 2001 | ||||||||||||||||||||||||||||||||
e | 年号 | 1 | ||||||||||||||||||||||||||||||||
ee | 年号 (2桁) | 01 | ||||||||||||||||||||||||||||||||
g | 元号 (アルファベットの頭文字) | S / H / R | ||||||||||||||||||||||||||||||||
gg | 元号 (漢字1文字) | 昭 / 平 / 令 | ||||||||||||||||||||||||||||||||
ggg | 元号 (漢字2文字) | 昭和 / 平成 / 令和 | ||||||||||||||||||||||||||||||||
月 | ||||||||||||||||||||||||||||||||||
m | 月 | 2 | ||||||||||||||||||||||||||||||||
mm | 月 (2桁) | 02 | ||||||||||||||||||||||||||||||||
mmm | 英語の月 (頭3文字) | Jan~Dec | ||||||||||||||||||||||||||||||||
mmmm | 英語の月 | January~December | ||||||||||||||||||||||||||||||||
mmmmm | 英語の月 (頭1文字) | J~D | ||||||||||||||||||||||||||||||||
日 | ||||||||||||||||||||||||||||||||||
d | 日 | 3 | ||||||||||||||||||||||||||||||||
dd | 日 (2桁) | 03 | ||||||||||||||||||||||||||||||||
曜日 | ||||||||||||||||||||||||||||||||||
ddd | 英語の曜日 (頭3文字) | Sun~Sat | ||||||||||||||||||||||||||||||||
dddd | 英語の曜日 | Sunday~Saturday | ||||||||||||||||||||||||||||||||
aaa | 漢字の曜日 (頭1文字) | 日~土 | ||||||||||||||||||||||||||||||||
aaaa | 漢字の曜日 | 日曜日~土曜日 | ||||||||||||||||||||||||||||||||
時間 (※ m・mm【分】:h・hh【時刻】の直後 または s・ss【秒】の直前 に指定) | ||||||||||||||||||||||||||||||||||
h | 時刻 | 0~23 | ||||||||||||||||||||||||||||||||
hh | 時刻 (2桁) | 00~23 | ||||||||||||||||||||||||||||||||
m ※ | 分 | 0~59 | ||||||||||||||||||||||||||||||||
mm ※ | 分 (2桁) | 00~59 | ||||||||||||||||||||||||||||||||
s | 秒 | 0~59 | ||||||||||||||||||||||||||||||||
ss | 秒 (2桁) | 00~59 | ||||||||||||||||||||||||||||||||
AM/PM | ||||||||||||||||||||||||||||||||||
h AM/PM h am/pm | 時 (12時間表示) (午前午後:AM | PM | am | pm) | |||||||||||||||||||||||||||||||||
h:mm AM/PM h:mm am/pm | 時分 (12時間表示) (午前午後:AM | PM | am | pm) | |||||||||||||||||||||||||||||||||
h:mm:ss A/P h:mm:ss a/p | 時分秒 (12時間表示) (午前午後:A | P | a | p) | |||||||||||||||||||||||||||||||||
経過時間 | ||||||||||||||||||||||||||||||||||
[h]:mm | 経過時間 (時分・時:24以上も可) | |||||||||||||||||||||||||||||||||
[mm]:ss | 経過時間 (分秒・分:60以上も可) | |||||||||||||||||||||||||||||||||
[ss] | 経過時間 (秒・秒:60以上も可) | |||||||||||||||||||||||||||||||||
単独表示可能な文字 (その他の文字は ダブルクォーテーションで囲む か \ でエスケープ) | ||||||||||||||||||||||||||||||||||
$ | ドル記号 | |||||||||||||||||||||||||||||||||
+ - | 正符号 負符号 | |||||||||||||||||||||||||||||||||
/ | スラッシュ | |||||||||||||||||||||||||||||||||
( ) | 丸カッコ | |||||||||||||||||||||||||||||||||
: | コロン | |||||||||||||||||||||||||||||||||
! | 感嘆符 | |||||||||||||||||||||||||||||||||
^ | キャレット | |||||||||||||||||||||||||||||||||
& | アンパサンド | |||||||||||||||||||||||||||||||||
' | アポストロフィ | |||||||||||||||||||||||||||||||||
^ | チルダ | |||||||||||||||||||||||||||||||||
{ } | 波カッコ | |||||||||||||||||||||||||||||||||
< > | 小なり大 大なり小 | |||||||||||||||||||||||||||||||||
= | 等号 |
関数〔 例 〕
関数 | 備考 |
---|---|
builtin_format_code(index) | 組み込み表示形式 取得 戻り値 (str)組み込み表示形式 (None:なし) index組み込み表示形式インデックス (定数 参照) |
builtin_format_id(fmt) | 組み込み表示形式インデックス 取得 戻り値 (int)組み込み表示形式インデックス (None:なし / 定数 参照) fmt (str)表示形式 |
is_builtin(fmt) | 組み込み表示形式チェック 戻り値 (bool)チェック結果 True:組み込み表示形式 False:その他 fmt (str)チェックする表示形式 |
is_date_format(fmt) | 日付表示形式チェック 戻り値 (bool)チェック結果 True:日付表示形式 False:その他 fmt (str)チェックする表示形式 |
is_datetime(fmt) | 日時表示形式チェック 戻り値 (str)チェック結果 'datetime':日時表示形式 'date':日付表示形式 'time':時間表示形式 None:その他 fmt (str)チェックする表示形式 |
is_timedelta_format(fmt) | 経過時間表示形式チェック 戻り値 (bool)チェック結果 True:経過時間表示形式 False:その他 fmt (str)チェックする表示形式 |
NumberFormat【表示形式 (内部使用)】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable | |
class NumberFormat( numFmtId=None, formatCode=None) | 表示形式 numFmtId (int) formatCode (str) |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
formatCode | str | |
numFmtId | int |
NumberFormatDescriptor【表示形式ディスクリプタ】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.String | |
class NumberFormatDescriptor( *args, **kw) | 表示形式ディスクリプタ args kw |
操作
操作 | 備考 |
---|---|
設定 | (未使用) None 指定は General【G/標準】 |
NumberFormatList【表示形式リスト (内部使用)】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable | |
class NumberFormatList( count=None, numFmt=() ) | count numFmt |
操作
操作 | 備考 |
---|---|
項目取得 |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
count | int |