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