Skip to main content

給懂中文的程式設計師

命名原則及數字處理

本程式庫設計哲學就是函數以中文命名且能簡明表達功能, 函數命名係以「動詞」加「受詞」為原則,受詞表達傳入參數,動詞表達函數功能。 另以簡體名稱表示處理簡體中文情形, 繁體名稱表示處理繁體中文情形。 舉如中文數字處理模組(zhongwen.數)用法示例:

from zhongwen.數 import 取中文數字, 取中文数字, 取大寫中文數字
取中文數字(10600)
>>> '一萬零六百'
取中文数字(10600)
>>> '一万零六百'
取大寫中文數字(23232.00518)
>>> '貳萬參仟貳佰參拾貳點零零伍壹捌'

民國日期處理

臺灣地區使用民國紀年, 【取日期】函數可將民國日期字串轉成時間資料(pd.Timestamp), 而【取民國日期】可將時間資料轉成表達民國紀年日期之字串,示例如次:

from zhongwen.時 import 取日期
from pandas import Timestamp
取日期('111.9.23')
>>> Timestamp(2022,9,23,0,0)
取日期('110/12/27')
>>> Timestamp(2021,12,27,0,0)

from zhongwen.時 import 取民國日期
取民國日期(datetime(2021,12,27,0,0), '%Y年%M月%d日')
>>> '110年12月27日'

中文字元判斷

中文字元判斷功能示例如次:

from zhongwen.文 import 是否為中文字元

是否為中文字元('繁')
>>> True
是否為中文字元('简')
>>> True
是否為中文字元('a')
>>> False

校正重碼字

字型相似編碼相異之中文字元稱【重碼字】, 如【車】編碼為\u8eca(正式字集), 而【車】編碼為\uf902(中日韓相容表意文字區), 其細明體字形幾無差異。 而中日韓相容表意文字區[\uF900-\uFAFF]字元依字源分離原則未與正式字集(包括擴展 A、B、C、D 區)中的字形統一的字,因為許多「第三方字型」都沒有實作這個區域的文字, 【校正中文字】可將重碼字均轉為正體字,即輸入法優先輸出的編碼,以因使用字型未包含中日韓相容表意文字編碼,而以細明體字型表示造成同字卻字型不一問題。

校正中文字示例:

校正中文字('汽車')
>>> '汽車'

查中文字典

示例:

查萌典('查')
>>> ['ㄔㄚˊ:考察、檢查。翻閱、檢尋。大筏,水中的浮木。', 
     'ㄓㄚ:姓。如五代時南唐有查文徽。我。同「咱」(一)。']

翻譯

【翻譯】可將外國文字譯為中文,示例如次:

from zhongwen.文 import 翻譯
翻譯('test')
>>> '測試'
翻譯('取り')
>>> '拿'

安裝

安裝步驟如次:

py -m pip install zhongwen
py -m zhongwen.pdf --setup

Metadata

Release files for zhongwen 5.35.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zhongwen 5.35.22
File Size Uploaded
zhongwen-5.35.22.tar.gz 15.7 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for zhongwen 5.35.22
File Interpreter ABI Platform
zhongwen-5.35.22-py3-none-any.whl Python 3 none any Details

Total release size: 28.6 MB

Release files / zhongwen-5.35.22.tar.gz

Download URL zhongwen-5.35.22.tar.gz
Size 15.7 MB
Tags Source
SHA-256 checksum
How to use checksums
4624d340f64d62c2f0cf09f34cf1eed3686d073dfcb249042262c995e4553f7e
BLAKE2b-256 checksum
How to use checksums
203094045d96fcc3eb43e9237be047e2bdd9fa6cffd1035a7cf389833f48bd6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / zhongwen-5.35.22-py3-none-any.whl

Download URL zhongwen-5.35.22-py3-none-any.whl
Size 13.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
604a7eb3708941720466cdc7df435e469e747ff14de87cb5899cfc378d4691c4
BLAKE2b-256 checksum
How to use checksums
321c3b3cb81f15264d65c45ac1f857aae5dc53d5393d5a227693ead5f214f5fa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

5.35.22 This release

2 release files

5.35.5

2 release files

5.35.2

2 release files

5.33

2 release files

5.32

2 release files

5.31

2 release files

5.30

2 release files

5.29

2 release files

5.28

2 release files

5.27

2 release files

5.26

2 release files

5.25

2 release files

5.24

2 release files

5.23

2 release files

5.22

2 release files

5.21

2 release files

5.20

2 release files

5.19

2 release files

5.18

2 release files

5.17

2 release files

5.16

2 release files

5.15

2 release files

5.14

2 release files

5.13

2 release files

5.12

2 release files

5.11

2 release files

5.1

2 release files

3.1415

2 release files

3.1412

2 release files

3.141

2 release files

3.21

2 release files

3.14

2 release files

3.1

2 release files

3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page