قالبهای تاریخ-زمان و عدد به شما امکان میدهند نحوه نمایش دادههای خود را در یک برگه کنترل کنید. Google Sheets برخی از قالبهای رایج را برای انتخاب ارائه میدهد، اما میتوانید قالبهای خود را نیز تعریف کنید.
در رابط کاربری Sheets، شما با استفاده از منوی Format > Number، قالبهای عددی و تاریخی را به سلولها اعمال میکنید. در API Sheets، این قالبها را با استفاده از فراخوانی متد spreadsheets.batchUpdate برای ارسال UpdateCellsRequest یا RepeatCellRequest تنظیم میکنید.
این صفحه نحوه تعریف الگوهای جدید قالببندی تاریخ و عدد را شرح میدهد که میتوانید در درخواست API خود بگنجانید. نمونه « تنظیم قالب تاریخ و زمان سفارشی یا اعشاری برای یک محدوده» نحوه تنظیم الگوی قالببندی را با استفاده از API نشان میدهد. توجه داشته باشید که نمایش واقعی قالب به locale صفحه گسترده بستگی دارد. این راهنما فرض میکند که locale en_US است. میتوانید locale یک صفحه گسترده را با خواندن SpreadsheetProperties با درخواست spreadsheets.get تعیین کنید.
درباره مقادیر تاریخ و زمان
Sheets، مانند اکثر برنامههای صفحهگسترده دیگر، مقادیر تاریخ و زمان را به عنوان مقادیر اعشاری در نظر میگیرد. این به شما امکان میدهد محاسبات را روی آنها در فرمولها انجام دهید، بنابراین میتوانید روزها یا هفتهها را افزایش دهید، دو تاریخ و زمان را جمع یا تفریق کنید و سایر عملیات مشابه را انجام دهید.
Sheets از نوعی تاریخگذاری عصر استفاده میکند که معمولاً در صفحات گسترده استفاده میشود. بخش عدد صحیح مقدار (سمت چپ اعشار) تعداد روزها را از 30 دسامبر 1899 شمارش میکند. بخش کسری (سمت راست اعشار) زمان را به عنوان کسری از یک روز شمارش میکند. به عنوان مثال، ظهر اول ژانویه 1900 برابر 2.5 است، 2 زیرا 2 روز پس از 30 دسامبر 1899 است و 0.5 زیرا ظهر نصف روز است. ظهر اول فوریه 1900 ساعت 3 بعد از ظهر 33.625 است.
Sheets به درستی سال ۱۹۰۰ را به عنوان یک سال عادی در نظر میگیرد، نه یک سال کبیسه.
الگوهای قالببندی تاریخ و زمان
الگوی قالب تاریخ-زمان ، رشتهای از زیررشتههای توکن است که هنگام تجزیه، با عناصر تاریخ-زمان مربوطه (مانند ماه یا ساعت) جایگزین میشوند.
توکنهای قالببندی تاریخ و زمان
جدول زیر، زیررشتههای توکنی را که میتوانید در الگوی قالببندی تاریخ-زمان استفاده کنید، تعریف میکند. کاراکتر + نشان میدهد که کاراکتر قبلی میتواند یک یا چند بار ظاهر شود و همچنان با الگو مطابقت داشته باشد. کاراکترهایی که در جدول زیر فهرست نشدهاند، به عنوان حروف حقیقی در نظر گرفته میشوند و بدون تغییر نمایش داده میشوند.
| توکن | توضیحات |
|---|---|
h | ساعت روز. بسته به اینکه نشانگر AM یا PM در رشته وجود داشته باشد، بین قالب ۱۲ و ۲۴ ساعته تغییر میکند. |
hh+ | همانند مورد قبلی، اما با ۰ مقدم برای ۱-۹. |
m | اگر توکن غیرلفظی قبلی hours یا توکن بعدی seconds باشد، دقیقه را در ساعت نشان میدهد (بدون 0 مقدم). در غیر این صورت، ماه سال را به صورت عدد (بدون 0 مقدم) نشان میدهد. |
M | ماه سال بدون ۰ اول. از این توکن برای بیان صریح ماه، به جای دقیقه، در الگوی خود استفاده کنید. |
mm | همانند m است، اما برای هر دو مورد با 0 آغازین نمایش داده میشود. |
MM | ماه سال با 0 مقدم. از این توکن برای بیان صریح ماه، به جای دقیقه، در الگوی خود استفاده کنید. |
mmm | مخفف سه حرفی ماه (مثلاً "Feb"). |
mmmm | نام کامل ماه. mmmmmm+ نیز با این مورد مطابقت دارد. |
mmmmm | حرف اول ماه (مثلاً «J» برای ماه ژوئن). |
s | ثانیه در دقیقه بدون صفر ابتدایی. |
ss | ثانیهها در دقیقه با ۰ قبل از آن. |
[h+] | تعداد ساعات سپریشده در یک بازه زمانی. تعداد حروف نشاندهنده حداقل تعداد ارقام است (با اضافه کردن صفرهای ابتدایی). |
[m+] | تعداد دقایق سپریشده در یک بازه زمانی. تعداد حروف نشاندهنده حداقل تعداد ارقام است (با اضافه کردن صفرهای ابتدایی). |
[s+] | تعداد ثانیههای سپریشده در یک بازه زمانی. تعداد حروف نشاندهنده حداقل تعداد ارقام است (با اضافه کردن صفرهای ابتدایی). |
d | روز ماه، بدون ۰ ابتدایی برای اعداد کمتر از ۱۰. |
dd | روز ماه، به همراه ۰ مقدم برای اعداد کمتر از ۱۰. |
ddd | روز هفته، مخفف سه حرفی (مثلاً «دوشنبه»). |
dddd+ | روز هفته، نام کامل. |
y | سال دو رقمی. |
yy | |
yyy | سال ۴ رقمی. |
yyyy+ | |
a/p | برای صبح (AM) "a" و برای بعد از ظهر (PM) "p" را نمایش میدهد. همچنین فرمت ساعت را به ۱۲ ساعته تغییر میدهد. اگر حرف توکن بزرگ باشد، خروجی نیز بزرگ خواهد بود. |
am/pm | مانند بالا، اما به جای آن «AM» یا «PM» را نمایش میدهد و همیشه با حروف بزرگ نوشته میشود. |
0 | دهم ثانیه. میتوانید با استفاده 00 دقت را به دو رقم یا با 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 | ۴:۰۸:۵۳.۵۳ ص |
hh:mm A/P".M." | ۰۴:۰۸ بعد از ظهر |
yyyy-mm-dd | ۲۰۱۶-۰۴-۰۵ |
mmmm d \[dddd\] | ۵ آوریل [سهشنبه] |
h PM, ddd mmm dd | ساعت ۴ بعد از ظهر، سهشنبه ۵ آوریل |
dddd, m/d/yy at h:mm | سهشنبه، 1395/04/05 ساعت 16:08 |
| الگوهای زمان سپری شده | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 | ۰۳:۱۳:۴۱.۲۵۵ |
[mmmm]:[ss].000 | ۰۱۹۳:۴۱.۲۵۵ |
الگوهای قالببندی اعداد
الگوی قالببندی اعداد ، رشتهای از زیررشتههای توکن است که هنگام تجزیه، با نمایشهای عددی مربوطه جایگزین میشوند. یک الگوی قالببندی اعداد میتواند تا چهار بخش داشته باشد که با نقطهویرگول از هم جدا شدهاند و قالبهای جداگانه مورد استفاده برای اعداد مثبت، اعداد منفی، صفر و متن (به همین ترتیب) را تعریف میکنند:
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
لازم نیست هر چهار بخش را در یک قالب قرار دهید. اگر فقط یک بخش را قرار دهید، آن قالب برای همه مقادیر استفاده میشود. استفاده از دو بخش باعث میشود قالب اول برای اعداد صفر و مثبت و قالب دوم برای اعداد منفی اعمال شود. استفاده از سه بخش، قالبهای جداگانهای را برای اعداد مثبت، منفی و صفر تعریف میکند. به عنوان مثال:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
با این حال، اگر دو یا چند بخش وجود داشته باشد و بخش آخر یک قالب متنی باشد، آن بخش به عنوان قالب متنی در نظر گرفته میشود و بقیه طوری رفتار میکنند که انگار یک بخش کمتر وجود دارد. بنابراین، با گنجاندن یک قالب متنی نهایی، میتوان قالبهایی مانند موارد زیر را تعریف کرد:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
تجزیه یک قالب به بخشهای مختلف، قبل از تجزیههای دیگر رخ میدهد، بنابراین میتوان یک قالب تاریخ یا زمان را به عنوان یکی از بخشها در نظر گرفت (هرچند این قابلیت کاربرد محدودی دارد).
توکنهای قالببندی اعداد
جدول زیر، زیررشتههای توکنی را که میتوانید در یک بخش قالببندی برای تعریف نحوه نمایش مقادیر آن بخش استفاده کنید، تعریف میکند.
| توکن | توضیحات |
|---|---|
0 | نشان دهنده یک رقم در عدد است. اگر رقم یک 0 ناچیز باشد، به صورت 0 نمایش داده میشود. برای مثال، قالب عددی 00.0 عدد 3 را به صورت " 03.0 " نمایش میدهد. |
# | نشان دهنده یک رقم در عدد است. اگر رقم یک 0 بیاهمیت باشد، نمایش داده نمیشود. برای مثال، قالب عددی ##0 عدد 12 را به صورت " 12 " نمایش میدهد. |
? | نشان دهنده یک رقم در عدد است. اگر رقم یک ۰ ناچیز باشد، به صورت یک فاصله نمایش داده میشود. این اغلب برای تراز کردن نقطه اعشار در یک ستون هنگام استفاده از فونتهای با عرض ثابت استفاده میشود. به عنوان مثال، قالب عددی ???.??? عدد ۱۲.۴ را به صورت " 12.4 " نمایش میدهد. |
. | نقطه اول نشان دهنده نقطه اعشار در عدد است. نقطههای بعدی به صورت حروف نمایش داده میشوند. اگر یک نقطه اعشار را در قالب قرار دهید، همیشه نمایش داده میشود، حتی برای اعداد صحیح. به عنوان مثال، #0.# عدد 3 را به صورت " 3. " نمایش میدهد. |
% | به صورت یک عدد حقیقی نمایش داده میشود، اما باعث میشود اعداد موجود قبل از نمایش در ۱۰۰ ضرب شوند تا درصدها خواناتر شوند. برای مثال، قالب عددی #% عدد ۰.۲۵ را به صورت " 25% " نمایش میدهد. |
, | اگر بین کاراکترهای دو رقمی ( 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+ | |
/ | اگر بین کاراکترهای دو رقمی ( 0 ، # یا ? ) ظاهر شود، آن گروههای رقمی را به عنوان یک قالب کسری در نظر میگیرد. برای مثال، قالب عددی 0 #/# عدد 23.25 را به صورت 23 1/4 نمایش میدهد. مخرج همچنین میتواند یک عدد صحیح تحتاللفظی باشد، در این صورت آن عدد صحیح را به عنوان مخرج اعمال میکند. قالب عددی 0 #/8 عدد 23.25 را به صورت 23 2/8 نمایش میدهد. اگر صورت کسر 0 شود، بخش کسری نمایش داده نمیشود. عدد 23.1 با قالب عددی 0 #/3 فقط به صورت 23 نمایش داده میشود (زیرا 0.1 به 0/3 گرد میشود). / با قالب علمی یا قالبی که دارای نقطه اعشار است سازگار نیست. |
* | این مورد برای سازگاری با قالبهای عددی مایکروسافت اکسل گنجانده شده است. در حال حاضر نادیده گرفته میشود. |
_ | علامت زیرخط (underscore) از کاراکتر بعدی عبور کرده و یک فاصله (space) ایجاد میکند. این علامت برای مرتب کردن قالبهای عددی استفاده میشود که در آنها مقدار منفی توسط پرانتز احاطه شده است. |
\ | کاراکتر بعدی را به عنوان یک مقدار تحتاللفظی در نظر میگیرد و هیچ معنای خاصی که ممکن است داشته باشد را در نظر نمیگیرد. برای مثال، قالب عددی \#0 عدد 10 را به صورت " #10 " نمایش میدهد. |
"text" | هر متنی که داخل علامت نقل قول باشد را به صورت تحت اللفظی نمایش میدهد. |
@ | اگر سلول ورودی متن داشته باشد، متن خام را برای سلول وارد میکند. با هیچ یک از کاراکترهای خاص دیگر سازگار نیست و برای مقادیر عددی (که به صورت قالب کلی نمایش داده میشوند) نمایش داده نمیشود. |
$ - + ( ) : space | Sheets با این کاراکترها به عنوان حروف الفبا رفتار میکند و آنها را بدون تغییر نمایش میدهد. |
دستورالعملهای متا
علاوه بر این، هر یک از بخشهای قالببندی میتوانند دارای دستورالعملهای متای اختیاری باشند که درون کاراکترهای [] قرار میگیرند و قبل از قالببندی قرار میگیرند و دستورالعملهای اضافی ارائه میدهند. دو نوع دستورالعمل متا وجود دارد و یک بخش مشخص میتواند از هر دو استفاده کند:
| دستورالعمل | توضیحات |
|---|---|
[ condition ] | مقایسهی پیشفرض مثبت، منفی یا صفر بخش را با یک عبارت شرطی دیگر جایگزین میکند. برای مثال، [<100]”Low”;[>1000]”High”;000 برای مقادیر کمتر از ۱۰۰ کلمه “Low”، برای مقادیر بالاتر از ۱۰۰۰ کلمه “High” و برای هر عددی بین این دو، یک عدد سه رقمی (با ۰های ابتدایی) را نمایش میدهد. شرایط فقط میتوانند برای دو زیرقالب اول اعمال شوند و اگر عددی با بیش از یک عدد مطابقت داشته باشد، از اولین عددی که با آن مطابقت دارد استفاده میکند. اگر فرمت سومی وجود داشته باشد، برای “هر چیز دیگری” استفاده میشود، در غیر این صورت اگر عددی با هیچ یک از فرمتها مطابقت نداشته باشد، به صورت پر شدن تمام عرض سلول با “#” نمایش داده میشود. در صورت وجود، فرمت چهارم همیشه برای متن استفاده میشود. |
[ Color ] or [ Color# ] | باعث میشود هر مقداری که این زیرقالب ارائه میدهد با رنگ متن داده شده نمایش داده شود. مقادیر معتبر برای Color عبارتند از مشکی، آبی، فیروزهای، سبز، ارغوانی، قرمز، سفید یا زرد. مقادیر معتبر برای "#" در Color# از ۱ تا ۵۶ است (این پالت رنگ لیستی از رنگهای مربوط به هر عدد را نشان میدهد). رنگهای قالب اعداد، هر رنگ وارد شده توسط کاربر را در سلول لغو میکنند، اما رنگهای تعیین شده توسط قالببندی شرطی را لغو نمیکنند. |
مثالهای قالببندی اعداد
جدول زیر چند الگوی نمونه و نحوهی نمایش اعداد فرمتبندیشدهی مربوط به آنها را نشان میدهد:
| شماره | الگو | مقدار قالببندی شده |
|---|---|---|
| ۱۲۳۴۵.۱۲۵ | ####.# | ۱۲۳۴۵.۱ |
| ۱۲.۳۴ | 000.0000 | ۰۱۲.۳۴۰۰ |
| ۱۲ | #.0# | ۱۲.۰ |
| ۵.۱۲۵ | # ???/??? | ۵ ۱/۸ |
| ۱۲۰۰۰ | #,### | ۱۲۰۰۰ |
| ۱۲۳۰۰۰۰ | 0.0,,"M" | ۱.۲ میلیون |
| ۱۲۳۴۵۰۰۰۰۰ | 0.00e+00 | ۱.۲۳e+۰۹ |
| ۱۲۳۱۱۴.۱۵۱۱۵ متن من | ###0.000;"TEXT: "_(@_) | ۱۲۳۱۱۴.۱۵۱ متن: متن من |
| ۱۲۳۴ -۱۲۳۴ 0 متن من | [Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) | ۱,۲۳۴ ۱,۲۳۴ ۰.۰ متن من |
| ۱۰۰۵ ۳۲ ۵۲۷ | [>1000]"HIGH";[Color43][<=200]"LOW";0000 | بالا کم ۰۵۲۷ |