รูปแบบวันที่และเวลาแบบตัวเลขช่วยให้คุณควบคุมวิธีที่ข้อมูลจะปรากฏในชีต Google ชีตมีรูปแบบทั่วไปให้คุณเลือก และคุณยังกําหนดรูปแบบเองได้ด้วย
ใน UI ของชีต คุณจะใช้รูปแบบตัวเลขและวันที่กับเซลล์ได้โดยใช้เมนูรูปแบบ > ตัวเลข ใน Sheets API คุณสามารถกําหนดรูปแบบเหล่านี้ได้โดยใช้การเรียกเมธอด spreadsheets.batchUpdate เพื่อส่ง UpdateCellsRequest หรือ RepeatCellRequest
หน้านี้อธิบายวิธีกําหนดรูปแบบวันที่และตัวเลขใหม่ที่คุณรวมไว้ในคําขอ API ได้ ตัวอย่าง
ตั้งค่ารูปแบบวันที่และเวลาแบบกําหนดเองสําหรับช่วง
จะแสดงวิธีตั้งค่ารูปแบบรูปแบบโดยใช้ API โปรดทราบว่าการแสดงผลจริงของรูปแบบจะขึ้นอยู่กับ locale ของสเปรดชีต คู่มือนี้จะถือว่า locale เป็น en_US คุณกําหนด locale ของสเปรดชีตได้โดยอ่าน
SpreadsheetProperties
ด้วยคําขอ spreadsheets.get
เกี่ยวกับค่าวันที่และเวลา
Google ชีตถือว่าค่าวันที่และเวลาเป็นค่าทศนิยมเหมือนกับแอปพลิเคชันสเปรดชีตอื่นๆ ส่วนใหญ่ วิธีนี้ช่วยให้คุณคํานวณเลขในสูตรเพื่อให้เพิ่มจํานวนวันหรือสัปดาห์ได้ เพิ่มหรือลบวันที่และเวลา 2 รายการ แล้วดําเนินการอื่นๆ ที่คล้ายกันได้
ชีตใช้รูปแบบวันที่ Epoch ซึ่งใช้กันโดยทั่วไปในสเปรดชีต ส่วนจํานวนเต็มของค่า
(ทศนิยมของทศนิยม) จะนับจํานวนวันตั้งแต่วันที่ 30 ธันวาคม 1899 ส่วนเศษส่วน (ทศนิยม) จะนับเวลาเป็นเศษส่วนของวัน เช่น วันที่ 1 มกราคม 1900 ตอนเที่ยงคือ 2.5 2 เพราะเป็นเวลา 2 วันหลังจากวันที่ 30 ธันวาคม 1899 และ 0.5 เพราะเที่ยงวันคือครึ่งวัน วันที่ 1 กุมภาพันธ์ 1900 เวลา 15:00 น.
คือ 33.625
ชีตถือว่าปี 1900 เป็นปีทั่วไป ไม่ใช่ปีอธิกสุรทิน
รูปแบบวันที่และเวลา
รูปแบบรูปแบบวันที่และเวลาเป็นสตริงของสตริงย่อยของโทเค็น ซึ่งเมื่อแยกวิเคราะห์แล้วจะมีการแทนที่ด้วยองค์ประกอบวันที่และเวลาที่เกี่ยวข้อง (เช่น เดือนหรือชั่วโมง)
โทเค็นรูปแบบวันที่และเวลา
ตารางต่อไปนี้กําหนดสตริงย่อยของโทเค็นที่คุณจะใช้ในรูปแบบรูปแบบวันที่และเวลาได้ อักขระ + บ่งบอกว่าอักขระก่อนหน้าสามารถปรากฏอย่างน้อย 1 ครั้งและยังคงตรงกับรูปแบบ ระบบจะถือว่าอักขระที่ไม่ได้แสดงในตารางด้านล่างเป็นอักขระตามตัวอักษร และเป็นเอาต์พุตโดยไม่มีการเปลี่ยนแปลง
| โทเค็น | คำอธิบาย |
|---|---|
h |
เวลาของวัน สลับระหว่างรูปแบบ 12 ถึง 24 ชั่วโมง โดยขึ้นอยู่กับว่ามีตัวบ่งชี้ AM หรือ PM ในสตริงหรือไม่ |
hh+ |
เหมือนกับรายการก่อนหน้า แต่มีค่า 0 นําหน้า 1-9 |
m |
หากโทเค็นที่ไม่ใช่ตัวอักษรก่อนหน้านี้เป็นชั่วโมงหรือโทเค็นที่ตามมาคือเป็นวินาที แทนจํานวนนาทีในชั่วโมง (ไม่มีเลข 0 นําหน้า) มิเช่นนั้น จะแสดงเป็นเดือนของปีเป็นตัวเลข (ไม่มี 0 นําหน้า) |
M |
เดือนของปีที่ไม่มี 0 นําหน้า ใช้โทเค็นนี้เพื่อระบุเดือนในรูปแบบแทนที่จะเป็น 1 นาที |
mm |
เหมือนกับ m แต่มีค่า 0 นําหน้าสําหรับทั้งสองกรณี |
MM |
เดือนของปีที่มี 0 นําหน้า ใช้โทเค็นนี้เพื่อระบุเดือนในรูปแบบแทนที่จะเป็น 1 นาที |
mmm |
ตัวย่อระยะเวลา 3 เดือน (เช่น "ก.พ.") |
mmmm |
ชื่อเดือนแบบเต็ม mmmmmm+ ยังจับคู่กับรายการนี้ด้วย |
mmmmm |
ตัวอักษรแรกของเดือน (เช่น "J" สําหรับเดือนมิถุนายน) |
s |
วินาทีเป็นวินาทีที่ไม่มี 0 นําหน้า |
ss |
วินาทีในนาทีที่มี 0 นํา |
[h+] |
จํานวนชั่วโมงที่ผ่านไปในระยะเวลาหนึ่ง จํานวนตัวอักษรหมายถึงจํานวนตัวเลขขั้นต่ํา (เพิ่มเลข 0 นําหน้า) |
[m+] |
จํานวนนาทีที่ผ่านไปในระยะเวลาหนึ่ง จํานวนตัวอักษรหมายถึงจํานวนตัวเลขขั้นต่ํา (เพิ่มเลข 0 นําหน้า) |
[s+] |
จํานวนวินาทีที่ผ่านไปในระยะเวลาหนึ่ง จํานวนตัวอักษรหมายถึงจํานวนตัวเลขขั้นต่ํา (เพิ่มเลข 0 นําหน้า) |
d |
วันที่ของเดือน โดยไม่มีค่า 0 สําหรับตัวเลขที่น้อยกว่า 10 |
dd |
วันของเดือนที่มี 0 นําหน้าสําหรับตัวเลขที่น้อยกว่า 10 |
ddd |
วันของสัปดาห์ อักษรย่อ 3 ตัว (เช่น "จ.") |
dddd+ |
วันของสัปดาห์ ชื่อและนามสกุล |
y |
ปี 2 หลัก |
yy |
|
yyy |
ปี 4 หลัก |
yyyy+ |
|
a/p |
แสดง "a" สําหรับ AM และ "p" สําหรับ PM และยังเปลี่ยนรูปแบบเวลาเป็น 12 ชั่วโมงด้วย หากอักษรตัวพิมพ์ใหญ่เป็นตัวพิมพ์ใหญ่ เอาต์พุตก็จะเป็น |
am/pm |
ตามที่กล่าวไว้ข้างต้น แต่จะแสดง "AM" หรือ "PM" แทน และการใช้อักษรตัวพิมพ์ใหญ่เสมอ |
0 |
10 วินาที คุณเพิ่มความแม่นยําเป็น 2 หลักได้ด้วย 00 หรือ 3 หลัก (มิลลิวินาที) ด้วย 000 |
\ |
จะถือว่าอักขระถัดไปเป็นค่าจริง และไม่ได้มีความหมายพิเศษใดๆ |
"text" |
แสดงข้อความใดก็ตามที่อยู่ภายในเครื่องหมายคําพูดเป็นตัวอักษรตามตัวอักษร |
ตัวอย่างรูปแบบวันที่และเวลา
เมื่อดูวันที่และเวลาของ Tuesday, April 5, 2016, 4:08:53.528 PM ตารางต่อไปนี้จะแสดงรูปแบบตัวอย่างและการแสดงผลวันที่และเวลาที่เกี่ยวข้อง ส่วนที่ 2 ของตารางแสดงตัวอย่างรูปแบบเวลาที่ผ่านไปของเวลาที่ผ่านไปของ 3 hours, 13 minutes, 41.255 seconds ดังนี้
| รูปแบบวันที่และเวลา | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
16:08:53.53 น. |
hh:mm A/P".M." |
16:08 น. |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 เมษายน [วันอังคาร] |
h PM, ddd mmm dd |
16.00 น. อังคาร 05 เม.ย. |
dddd, m/d/yy at h:mm |
วันอังคารที่ 5/4/16 เวลา 16:08 น. |
| รูปแบบเวลาที่ใช้ไป | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
3:13:41.255 |
[mmmm]:[ss].000 |
1193:41.255 |
รูปแบบตัวเลข
รูปแบบตัวเลขเป็นสตริงของสตริงย่อยของโทเค็นที่เมื่อแยกวิเคราะห์แล้ว ระบบจะแทนที่ค่าด้วยตัวเลขที่เกี่ยวข้อง รูปแบบตัวเลขประกอบด้วย 4 ส่วน โดยคั่นด้วยเครื่องหมายเซมิโคลอน ซึ่งจะกําหนดรูปแบบที่ใช้แยกสําหรับจํานวนบวก จํานวนลบ เลขศูนย์ และข้อความ (ตามลําดับนั้น)
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
คุณไม่จําเป็นต้องใส่ทั้ง 4 ส่วนในรูปแบบ หากคุณใส่เพียงส่วนเดียว รูปแบบดังกล่าวจะใช้กับค่าทั้งหมด การใช้ 2 ส่วนจะทําให้มีการใช้รูปแบบแรกกับตัวเลขที่เป็นบวกและตัวเลขที่ 2 และใช้รูปแบบที่ 2 กับตัวเลขที่เป็นค่าลบ การใช้ 3 ส่วนจะกําหนดรูปแบบแยกกันสําหรับตัวเลขที่เป็นจํานวนบวก ค่าลบ และเลข 0 ตัวอย่างเช่น
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
อย่างไรก็ตาม หากมีส่วนอย่างน้อย 2 ส่วนและส่วนสุดท้ายมีรูปแบบข้อความ ส่วนดังกล่าวจะถือว่าเป็นรูปแบบข้อความและส่วนอื่นๆ จะทําหน้าที่เหมือนมีส่วนน้อยลง ดังนั้น การใส่ข้อความรูปแบบสุดท้ายจะช่วยให้คุณกําหนดรูปแบบได้ เช่น
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
การแยกวิเคราะห์รูปแบบจะแบ่งเป็นส่วนๆ ก่อนการวิเคราะห์อื่นๆ จึงเป็นไปได้ที่จะมีรูปแบบวันที่หรือเวลาให้เป็นหนึ่งในส่วนดังกล่าว (แต่เป็นยูทิลิตีแบบจํากัด)
โทเค็นรูปแบบตัวเลข
ตารางต่อไปนี้ระบุสตริงย่อยของโทเค็นที่คุณจะใช้ในส่วนรูปแบบได้เพื่อกําหนดวิธีแสดงค่าของส่วนนั้น
| โทเค็น | คำอธิบาย |
|---|---|
0 |
แสดงตัวเลขในตัวเลข หากตัวเลขไม่มีนัยสําคัญ 0 ระบบจะแสดงตัวเลขเป็น 0 เช่น รูปแบบตัวเลข 00.0 แสดงผลหมายเลข 3 เป็น "03.0" |
# |
แสดงตัวเลขในตัวเลข หากตัวเลขไม่มีนัยสําคัญ 0 ระบบจะไม่แสดงผลตัวเลขดังกล่าว เช่น รูปแบบตัวเลข ##0 จะแสดงผลหมายเลข 12 เป็น "12" |
? |
แสดงตัวเลขในตัวเลข หากตัวเลขไม่มีนัยสําคัญ 0 ระบบจะแสดงผลเป็นพื้นที่ทํางาน ซึ่งมักจะใช้เพื่อปรับจุดทศนิยมในคอลัมน์
เมื่อใช้แบบอักษรความกว้างคงที่ เช่น รูปแบบตัวเลข ???.??? แสดงผลหมายเลข 12.4 เป็น
" 12.4 " |
. |
จุดแรกแสดงถึงจุดทศนิยมในตัวเลข ระบบจะแสดงจุดต่อตามตัวอักษรตามตัวอักษร หากคุณใส่จุดทศนิยมในรูปแบบ
ระบบจะแสดงตําแหน่งเสมอ แม้ว่าจะเป็นจํานวนเต็ม เช่น #0.# จะแสดงผลหมายเลข 3 เป็น "3." |
% |
ปรากฏเป็นอักขระตามจริง แต่จะทําให้จํานวนที่มีอยู่คูณด้วย 100 ก่อนแสดงผล เพื่อทําให้เปอร์เซ็นต์อ่านได้ง่ายขึ้น |
, |
หากปรากฏระหว่างอักขระ 2 หลัก (0, # หรือ ?) ระบบจะแสดงตัวเลขทั้งหมดด้วยตัวคั่นในการจัดกลุ่ม (จัดกลุ่มตามหลักพัน) หากเป็นไปตามอักขระตัวเลข ก็จะปรับขนาดตัวเลขทีละ 1,000 คอมมา (เช่น รูปแบบ #0.0,, จะแสดงผลตัวเลข 12,200,000 เป็น 12.2) |
E- |
แสดงผลตัวเลขในรูปแบบทางวิทยาศาสตร์โดยจัดรูปแบบทางด้านซ้ายของ E ที่ใช้สําหรับส่วนที่ไม่ใช่เลขชี้กําลังและการจัดรูปแบบทางด้านขวาของ E ที่ใช้สําหรับส่วนเลขชี้กําลัง E+ แสดงเครื่องหมาย + สําหรับเลขชี้กําลังบวก E- จะแสดงเฉพาะสัญญาณของเลขชี้กําลังเชิงลบ หากใช้ตัวพิมพ์เล็ก เอาต์พุต e จะเป็นตัวพิมพ์เล็กด้วย |
E+ |
|
e- |
|
e+ |
|
/ |
หากปรากฏในระหว่างอักขระ 2 หลัก (0, # หรือ ?) ระบบจะถือว่ากลุ่มตัวเลขเหล่านั้นเป็นรูปแบบเศษส่วน เช่น รูปแบบตัวเลข 0 #/# แสดงผลหมายเลข 23.25 เป็น 23 1/4 ตัวส่วนสามารถเป็นจํานวนเต็มทศนิยมได้ โดยในกรณีนี้จะบังคับใช้จํานวนเต็มนั้นเป็นตัวส่วน รูปแบบตัวเลข 0 #/8 จะแสดงหมายเลข 23.25 เป็น 23 2/8 หากไม่มีการแสดงเศษส่วนเป็น 0 ระบบจะไม่แสดงผลเศษส่วน ตัวเลข 23.1 ที่มีรูปแบบตัวเลข 0 #/3 จะแสดงเป็น 23 เท่านั้น (เนื่องจาก 0.1 จะปัดเศษเป็น 0/3) / ใช้ไม่ได้กับรูปแบบวิทยาศาสตร์หรือรูปแบบที่มีจุดทศนิยม |
* |
ซึ่งรวมถึงความเข้ากันได้กับรูปแบบตัวเลขของ Microsoft Excel เพราะระบบไม่ได้ดําเนินการใดๆ |
_ |
ข้ามอักขระถัดไปและแสดงพื้นที่ทํางาน ซึ่งจะใช้เพื่อจัดเรียงรูปแบบตัวเลขที่มีค่าลบอยู่ในวงเล็บ |
\ |
จะถือว่าอักขระถัดไปเป็นค่าจริง และไม่ได้มีความหมายพิเศษใดๆ |
"text" |
แสดงข้อความใดก็ตามที่อยู่ภายในเครื่องหมายคําพูดเป็นตัวอักษรตามตัวอักษร |
@ |
หากเซลล์มีอินพุตข้อความ ระบบจะแทรกข้อความดิบสําหรับเซลล์นั้น ใช้ไม่ได้กับสัญลักษณ์พิเศษอื่นๆ และจะไม่แสดงสําหรับค่าตัวเลข (ซึ่งแสดงเป็นรูปแบบทั่วไป) |
$ - + ( ) : space |
ชีตจะถือว่าอักขระเหล่านี้เป็นตัวอักษรและแสดงผลโดยไม่มีการเปลี่ยนแปลง |
คําสั่ง Meta
นอกจากนี้ แต่ละส่วนของรูปแบบอาจมีวิธีการเมตาที่ไม่บังคับ โดยให้ใส่อักขระ [] ตัว ซึ่งจะขึ้นต้นด้วยรูปแบบและแสดงวิธีการเพิ่มเติม วิธีการเมตามี 2 ประเภทและส่วนหนึ่งๆ จะใช้ได้ทั้ง 2 ประเภท
| โรงเรียนฝึกอบรม | คำอธิบาย |
|---|---|
[condition] |
แทนที่การเปรียบเทียบค่าเริ่มต้นที่เป็นบวก ค่าลบ หรือศูนย์ของส่วนด้วยนิพจน์เงื่อนไขอื่น เช่น [<100]”Low”;[>1000]”High”;000 จะแสดงผลคําว่า "ต่ํา" สําหรับค่าที่ต่ํากว่า 100, "สูง" สําหรับค่าที่สูงกว่า 1,000 และตัวเลข 3 หลัก (ที่มีเลข 0 นําหน้า) อย่างใดอย่างหนึ่ง เงื่อนไขใช้ได้กับรูปแบบย่อย 2 รูปแบบแรกเท่านั้น และในกรณีที่ตัวเลขตรงกันมากกว่า 1 รูปแบบ รูปแบบดังกล่าวจะใช้รูปแบบแรกที่ตรงกัน หากมีรูปแบบที่ 3 รูปแบบดังกล่าวจะใช้สําหรับ "อื่นๆ ที่เหลือ" ไม่เช่นนั้นตัวเลขจะไม่ตรงกับทั้ง 2 รูปแบบ ตัวเลขจะแสดงเป็น "#" เต็มความกว้างของเซลล์ หากมีอยู่แล้ว ระบบจะใช้รูปแบบที่ 4 สําหรับข้อความเสมอ |
[Color] or [Color#] |
ทําให้ค่าที่รูปแบบย่อยนี้แสดงปรากฏขึ้นพร้อมกับสีข้อความที่ระบุ ค่าที่ถูกต้องสําหรับ Color ได้แก่ ดํา, น้ําเงิน, เขียว, เขียว, ม่วงแดง, แดง, ขาว หรือเหลือง ค่าที่ถูกต้องสําหรับ "#" ใน Color# คือ 0&ndash1;56 (ชุดสีนี้แสดงรายการสีที่ตรงกับแต่ละหมายเลข) สีรูปแบบตัวเลขจะลบล้างสีที่ผู้ใช้ป้อนในเซลล์ แต่ไม่ลบล้างสีที่ตั้งค่าโดยการจัดรูปแบบตามเงื่อนไข |
ตัวอย่างรูปแบบตัวเลข
ตารางต่อไปนี้แสดงตัวอย่างรูปแบบและการแสดงผลตัวเลขที่จัดรูปแบบที่สอดคล้องกัน
| ตัวเลข | รูปแบบ | ค่าที่จัดรูปแบบ |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12.34 | 000.0000 |
13.34 น. |
| 12 | #.0# |
12.0 |
| 5.125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12,000 คน |
| 1230000 | 0.0,,"M" |
1.2 ล้าน |
| 1234500000 | 0.00e+00 |
19.03 + 9 |
| 123114.15115 ข้อความของฉัน |
###0.000;"TEXT: "_(@_) |
123114.151 ข้อความ: MyText |
| 1234 -1234 0 ข้อความของฉัน |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1,234 1,234 0.0 ข้อความของฉัน |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
สูง ต่ํา 0527 |