รูปแบบวันที่ เวลา และตัวเลขช่วยให้คุณสามารถควบคุมวิธีที่ข้อมูลของคุณปรากฏในชีต 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
Sheets จะถือว่าปี 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 ตัวอักษร (เช่น "จ.") | 
dddd+ | 
    วันในสัปดาห์ ชื่อเต็ม | 
y | 
    ปีแบบ 2 หลัก | 
yy | 
  |
yyy | 
    ปีแบบ 4 หลัก | 
yyyy+ | 
  |
a/p | 
    แสดง "a" สำหรับ AM และ "p" สำหรับ PM นอกจากนี้ยังเปลี่ยนชั่วโมงเป็น รูปแบบ 12 ชั่วโมงด้วย หากตัวอักษรโทเค็นเป็นตัวพิมพ์ใหญ่ ผลลัพธ์จะเป็น ด้วย | 
am/pm | 
    เช่นเดียวกับด้านบน แต่จะแสดง "AM" หรือ "PM" แทน และจะ เป็นตัวพิมพ์ใหญ่เสมอ | 
0 | 
    เศษหนึ่งส่วนสิบของวินาที คุณเพิ่มความแม่นยำเป็น 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 p | 
hh:mm A/P".M." | 
    04: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 ส่วนในรูปแบบ หากคุณระบุเพียงส่วนเดียว ระบบจะใช้รูปแบบนั้นกับค่าทั้งหมด การใช้ 2 ส่วนจะทำให้ระบบใช้รูปแบบแรกกับตัวเลข 0 และตัวเลขบวก และใช้รูปแบบที่สองกับตัวเลขลบ การใช้ 3 ส่วนจะกำหนดรูปแบบแยกกันสำหรับตัวเลขที่เป็นบวก ลบ และศูนย์ เช่น
[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] | 
    แทนที่การเปรียบเทียบค่าเริ่มต้นที่เป็นบวก ลบ หรือศูนย์ของส่วน
    ด้วยนิพจน์แบบมีเงื่อนไขอื่น  ตัวอย่างเช่น
    [<100]”Low”;[>1000]”High”;000 จะแสดงคำว่า
    "ต่ำ" สำหรับค่าที่ต่ำกว่า 100, "สูง" สำหรับค่าที่สูงกว่า 1,000 และตัวเลข 3 หลัก (มี 0 นำหน้า) สำหรับค่าที่อยู่ระหว่างนั้น เงื่อนไขจะใช้ได้กับรูปแบบย่อย 2 รูปแบบแรกเท่านั้น และหากตัวเลขตรงกับรูปแบบย่อยมากกว่า 1 รูปแบบ ระบบจะใช้รูปแบบย่อยแรกที่ตรงกัน  หากมีรูปแบบที่ 3 ระบบจะใช้รูปแบบดังกล่าวกับ "อื่นๆ ทั้งหมด" ไม่เช่นนั้น หากตัวเลขไม่ตรงกับรูปแบบใดรูปแบบหนึ่ง ระบบจะแสดงผลเป็นเครื่องหมาย "#" ทั้งหมดที่เติมความกว้างของเซลล์ หากมีอยู่ ระบบจะใช้รูปแบบที่สี่กับข้อความเสมอ
 | 
  
[Color] or [Color#] | 
    ทำให้ค่าใดก็ตามที่รูปแบบย่อยนี้แสดงปรากฏพร้อมกับ สีข้อความที่ระบุ ค่าที่ใช้ได้สำหรับ Color คือ Black, Blue, Cyan, Green, Magenta, Red, White หรือ Yellow ค่าที่ใช้ได้สำหรับ "#" ใน 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 ข้อความของฉัน  | 
    ###0.000;"TEXT: "_(@_) | 
    123114.151 TEXT: MyText  | 
  
| 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  |