รูปแบบวันที่และเวลาและตัวเลขช่วยให้คุณควบคุมการแสดงข้อมูลในชีตได้ Google ชีตมีรูปแบบทั่วไปให้เลือก และคุณยังกำหนดรูปแบบของตัวเองได้อีกด้วย
ใน UI ของชีต คุณสามารถใช้รูปแบบตัวเลขและวันที่กับเซลล์โดยใช้เมนูรูปแบบ > ตัวเลข ใน Sheets API คุณจะตั้งค่ารูปแบบเหล่านี้ได้โดยใช้การเรียกเมธอด spreadsheets.batchUpdate
เพื่อส่ง UpdateCellsRequest
หรือ RepeatCellRequest
หน้านี้จะอธิบายวิธีกำหนดรูปแบบวันที่และตัวเลขใหม่ ซึ่งคุณสามารถรวมไว้ในคำขอ API ได้ ตัวอย่าง
ตั้งค่ารูปแบบวันที่และเวลาที่กำหนดเองสำหรับช่วง
แสดงวิธีการตั้งค่ารูปแบบรูปแบบโดยใช้ API โปรดทราบว่าการแสดงผลจริงของรูปแบบจะขึ้นอยู่กับlocale
ของสเปรดชีต คู่มือนี้จะถือว่า locale
คือ en_US
คุณระบุ locale
ของสเปรดชีตได้โดยอ่าน SpreadsheetProperties
ที่มีคำขอ spreadsheets.get
เกี่ยวกับค่าวันที่และเวลา
ชีตจะถือว่าค่าวันที่และเวลาเป็นค่าทศนิยมเช่นเดียวกับแอปพลิเคชันสเปรดชีตอื่นๆ ส่วนใหญ่ ซึ่งจะช่วยให้คุณดำเนินการทางคณิตศาสตร์ในสูตรได้ โดยสามารถเพิ่มวันหรือสัปดาห์ เพิ่มหรือลบ 2 วันที่และเวลา และดำเนินการอื่นๆ ที่คล้ายกันได้
ชีตใช้รูปแบบของวันที่ Epoch ซึ่งใช้กันโดยทั่วไปในสเปรดชีต ส่วนที่เป็นจำนวนเต็มของค่า
(ซ้ายของทศนิยม) จะนับจำนวนวันตั้งแต่วันที่ 30 ธันวาคม 1899 เศษส่วน (ขวาของทศนิยม) จะนับเวลาเป็นเศษส่วนของ 1 วัน ตัวอย่างเช่น วันที่ 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 นำหน้า ใช้โทเค็นนี้เพื่อระบุเดือนในรูปแบบของคุณ แทนที่จะใช้นาทีอย่างชัดเจน |
mm |
เหมือนกับ m แต่มี 0 นําหน้าสําหรับทั้ง 2 กรณี |
MM |
เดือนของปีที่มีเลข 0 นำหน้า ใช้โทเค็นนี้เพื่อระบุเดือนในรูปแบบของคุณ แทนที่จะใช้นาทีอย่างชัดเจน |
mmm |
ตัวย่อเดือนแบบ 3 ตัวอักษร (เช่น "ก.พ.") |
mmmm |
ชื่อเต็มของเดือน mmmmmm+ ตรงกับรายการนี้ด้วย |
mmmmm |
อักษรแรกของเดือน (เช่น "J" สําหรับเดือนมิถุนายน) |
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" แทน 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 |
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 |
193:41.255 |
รูปแบบตัวเลข
รูปแบบตัวเลขเป็นสตริงย่อยของโทเค็นซึ่งเมื่อแยกวิเคราะห์ ระบบจะแทนที่จำนวนดังกล่าวด้วย รูปแบบตัวเลขสามารถมีได้สูงสุด 4 ส่วนโดยคั่นด้วยเครื่องหมายอัฒภาค ซึ่งจะกำหนดรูปแบบแยกต่างหากสำหรับตัวเลขบวก จำนวนลบ ศูนย์ และข้อความ (ตามลำดับนั้น)
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
คุณไม่จำเป็นต้องรวมทั้ง 4 ส่วนในรูปแบบหนึ่ง ถ้าคุณรวมเพียงส่วนเดียว รูปแบบนั้นจะใช้กับค่าทั้งหมด การใช้ 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 , # หรือ ? ) ระบบจะแสดงตัวเลขทั้งหมดด้วยตัวคั่นการจัดกลุ่ม (จัดกลุ่มตามหลักพัน) หากตามด้วยอักขระหลัก ระบบจะปรับขนาดตัวเลขเป็น 1,000 ครั้งต่อคอมมา (เช่น รูปแบบ #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# คือ 0&ndash1;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 ข้อความของฉัน |
###0.000;"TEXT: "_(@_) |
123114.151 ข้อความ: ข้อความของฉัน |
1234 -1234 0 ข้อความของฉัน |
[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 |