Template:數值/doc
 | 呢頁係Template:數值嘅說明文件（子頁）。 呢度包含咗用法資料、分類同埋其他唔屬於個模本身嘅內容。 |
名
[編輯]數值——用某種統一嘅方法顯示一個數值
參數同用法
[編輯]一般用法係畀一至兩個參數，第一個參數係要顯示嘅數值，唔特別指定嘅話會用阿拉伯數字顯示，每4字加1空格（傳統中式撇法，可以直接睇撇讀出萬、億、兆而唔使數數字）；如果有第二個參數嘅話，參數二係單位或者量詞。
數值可以用高級程式語言常用嘅科學記數法表示大數，例如 1e30 代表 1 × 10³⁰，即係 1 後面 30 個 0。｢e｣ 前面可以用小數，例如 1.23e30 代表 1.23 × 10³⁰，即係 123 後面 28 個 0；但係 ｢e｣ 後面一定要係正數。
如果指定用中文下數，會自動轉換做純漢字輸出，理由係一大串一個阿拉伯數字一個中文字太難睇。
單位同量詞處理
[編輯]個模會對 ｢攝氏度｣（同 ｢華氏度｣ 等等）特別拆開處理，會出例如 ｢攝氏 10 度｣ 而唔會出錯誤嘅 ｢10 攝氏度｣。
另外，如果數量係 2 而有單位，個模出嘅替代文字會用 ｢兩｣ 而唔用 ｢二｣。
參數一覽
[編輯]除咗參數一之外，全部都唔係必填：
| 參數 | 參數嘅參數 | 預設？ | 預設值 | 用途 | 同義詞 | 相反詞 |
|---|---|---|---|---|---|---|
| （空） | 唔啱使 | 唔啱使 | 表示前面係中文 | 冇 | 唔啱使 | |
| 參數一 | 唔啱使 | 唔啱使 | 數值 | 冇 | 唔啱使 | |
| 參數二 | 唔啱使 | 冇 | 單位／量詞 |
|
唔啱使 | |
| 上數 | 唔啱使 | 唔啱使 | 如果用中式顯示嘅話，用 ｢上數｣ 等級 | 唔啱使 |
| |
| 下數 | 唔啱使 | 唔啱使 | 如果用中式顯示嘅話，用 ｢下數｣ 等級 | 唔啱使 |
| |
| 大寫 | 唔啱使 | 唔啱使 | 所有中文（如果有）用大寫數字 | 冇 | 小寫 | |
| 小寫 | 唔啱使 | 模組預設 | 唔啱使 | 所有中文（如果有）用小寫數字 | 冇 | 大寫 |
| 中文 | 唔啱使 | 唔啱使 | 撇位用中文字，唔用撇 | 冇 | 加撇 | |
| 中式 | 唔啱使 | 模組預設 | 唔啱使 | 如果加撇嘅話，用中式撇法（通常指每4字加1空格） | 每4[註 1] | 西式 |
| 中數 | 唔啱使 | 模組預設 | 唔啱使 | 如果用中式顯示嘅話，用 ｢中數｣ 等級 | 唔啱使 |
|
| 加撇 | 唔啱使 | 模預設 | 唔啱使 | 輸出阿拉伯數字加空格或撇號 | 冇 | 中文 |
| 印式 | 唔啱使 | 唔啱使 | 用印度式撇法（十萬、千萬加撇，百萬唔加撇，其餘位同西式一樣） | 冇 |
| |
| 西式 | 唔啱使 | 唔啱使 | 用西式撇法，3字加一空格或撇號 | 每3 | 中式 | |
| 每 | =字數 | 視乎格式 | 每指定字數加一空格或撇號 | 每 | 唔啱使 | |
| 每3 | 唔啱使 | 唔啱使 | 用西式撇法，3字加一空格或撇號 | 冇 | 每4 | |
| 每4 | 唔啱使 | 唔啱使 | 用中式撇法，每4字加1空格或撇號 | 中式[註 2] | 每3 | |
| 純漢字 | 唔啱使 | 唔啱使 | 全部數字用中文字，唔用阿拉伯數字 | 冇 | 漏咗 | |
| 單位 | =單位 | 冇 | 用指定單位 | 參數二 | 唔啱使 | |
| 萬計 | 唔啱使 | 唔啱使 | 如果用中文嘅話，千以上淨用 ｢萬｣ | 冇 | 唔啱使 | |
| 量詞 | =量詞 | 冇 | 用指定量詞 | 參數二 | 唔啱使 | |
| 撇 | =撇號 | U+202F | 用指定撇號，唔用空格 | comma | 唔啱使 | |
| 億萬計 | 唔啱使 | 唔啱使 | 如果用中文嘅話，千以上淨用 ｢萬｣ 同 ｢億｣ | 冇 | 唔啱使 | |
| alt | 唔啱使 | 模預設 | 唔啱使 | 輸出加替代文字喺 HTML title | 冇 | 漏咗 |
| comma | =撇號 | 冇 | 用指定撇號，唔用空格 | 撇 | 唔啱使 | |
| every | =字數 | 視乎格式 | 每指定字數加一空格或撇號 | 每 | 唔啱使 | |
| unit | =單位 | 冇 | 用指定單位 |
|
唔啱使 |
範例
[編輯]正常例子：
- 打：
{{數值|123456789}} - 出：1 2345 6789（1 億 2345 萬 6789）
- 打：
{{數值|123456789|西式|撇=,}} - 出：123,456,789（123 million 456 千 789}}）
- 打：
{{數值|123456789|厘米}} - 出：1 2345 6789 厘米
- 打：
{{數值|123456789|厘米|中文}} - 出：1 億 2345 萬 6789 厘米
- 打：
{{數值|123456789|厘米|中文|純漢字}} - 出：一億二千三百四十五萬六千七百八十九厘米
- 打：
{{數值|123456789|中文|純漢字|大寫}} - 出：壹億貳仟叄佰肆拾伍萬陸仟柒佰捌拾玖
- 打：
{{數值|1e32|中文}}（1 後面 32 個 0） - 出：1 溝（日常生活唔會咁講，但係至少唔會誤導）
- 打：
{{數值|1e32|中文|萬計}} - 出：1 萬萬萬萬萬萬萬萬
- 打：
{{數值|1e32|中文|億萬計}} - 出：1 億億億億
- 打：
{{數值|3.14|純漢字}} - 出：三點一四
- 打：
{{數值|-2|度|純漢字}} - 出：負二度
- 打：
{{數值|-2|攝氏度|純漢字}} - 出：攝氏負二度
- 打：
2021年住咗{{數值||438,366|人}} - 出：2021年住咗 43 8366 人
- 打：
2021年住咗{{數值||438,366|人|純漢字}} - 出：2021年住咗四十三萬八千三百六十六人
特別例子：
- 打：
{{數值|123456789|印式|撇=,}} - 出：12,34,56,789（12 crore 34 lakh 56 千 789）
- 打：
{{數值|123456789|中文|下數}} - 出：一垓二京三兆四億五萬六千七百八十九
- 打：
{{數值|1e32|印式}} - 出：100 000 000 000 000 000 000 000 00 00 00 000
- 打：
{{數值|1e32|上數}} - 出：1 0000000000000000 00000000 0000 0000
- 打：
{{數值|1e32|中文|上數}}（日常生活唔會用上數） - 出：1 京（日常生活唔會咁講）
下數超出正常範圍會做適當處理，唔應該會出垃圾：
- 打：
{{數值|1e15|中文|下數}} - 出：十載
- 打：
{{數值|1e32|中文|下數}} - 出：一萬載載
注意事項
[編輯]模嘅編輯說明
[編輯]呢個模嘅真身係一個模組。
睇埋
[編輯]註
[編輯]