این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تاریخ & فرمت های اعداد

فرمت‌های تاریخ و زمان به شما امکان می‌دهند نحوه نمایش داده‌هایتان در یک برگه را کنترل کنید. Google Sheets برخی از قالب‌های رایج را برای انتخاب فراهم می‌کند، اما می‌توانید قالب‌های خود را نیز تعریف کنید.

در کاربرگ‌نگار، قالب‌های شماره و تاریخ را با استفاده از منوی Format > Number به سلول‌ها اعمال می‌کنید. در Sheets API، این قالب‌ها را با استفاده از فراخوانی روش spreadsheets.batchUpdate برای ارسال UpdateCellsRequest یا RepeatCellRequest تنظیم می‌کنید.

این صفحه نحوه تعریف الگوهای قالب جدید تاریخ و اعداد را توضیح می دهد که می توانید آنها را در درخواست API خود قرار دهید. نمونه تنظیم یک تاریخ سفارشی یا قالب اعشاری برای یک محدوده نشان می دهد که چگونه یک الگوی قالب را با استفاده از API تنظیم کنید. توجه داشته باشید که رندر واقعی قالب به locale صفحه گسترده بستگی دارد. این راهنما فرض می‌کند که locale en_US است. شما می توانید با خواندن SpreadsheetProperties با درخواست spreadsheets.get ، locale یک صفحه گسترده را تعیین کنید.

درباره مقادیر تاریخ و زمان

Sheets، مانند بسیاری دیگر از برنامه های صفحه گسترده، مقادیر تاریخ و زمان را به عنوان مقادیر اعشاری در نظر می گیرد. این به شما این امکان را می‌دهد تا در فرمول‌ها روی آنها حساب کنید، بنابراین می‌توانید روزها یا هفته‌ها را افزایش دهید، دو تاریخ و زمان را اضافه یا کم کنید و سایر عملیات مشابه را انجام دهید.

Sheets از شکلی از تاریخ دوره استفاده می کند که معمولاً در صفحات گسترده استفاده می شود. بخش اعداد کامل مقدار (سمت چپ اعشار) روزهای از 30 دسامبر 1899 را می شمارد. بخش کسری (راست اعشار) زمان را به عنوان کسری از یک روز حساب می کند. به عنوان مثال، 1 ژانویه 1900 در ظهر، 2.5 است، 2 زیرا 2 روز پس از 30 دسامبر 1899 است، و 0.5 ، زیرا ظهر نیم روز است. 1 فوریه 1900 در ساعت 3 بعد از ظهر 33.625 است.

Sheets به درستی سال 1900 را به عنوان یک سال معمولی تلقی می کند، نه یک سال کبیسه.

الگوهای قالب تاریخ و زمان

الگوی قالب تاریخ-زمان رشته‌ای از زیررشته‌های نشانه است که وقتی تجزیه می‌شوند، با عناصر تاریخ-زمان مربوطه (مانند ماه یا ساعت) جایگزین می‌شوند.

نشانه‌های قالب‌بندی تاریخ و زمان

جدول زیر زیر رشته های رمزی را که می توانید در الگوی قالب تاریخ-زمان استفاده کنید، تعریف می کند. کاراکتر + نشان می دهد که کاراکتر قبلی می تواند یک یا چند بار ظاهر شود و همچنان با الگو مطابقت داشته باشد. نویسه‌هایی که در جدول زیر فهرست نشده‌اند به‌عنوان لفظی در نظر گرفته می‌شوند و بدون تغییر خروجی می‌شوند.

رمز	توضیحات
`h`	ساعت از روز. بسته به اینکه نشانگر AM یا PM در رشته وجود داشته باشد، بین قالب 12 و 24 ساعته جابجا می شود.
`hh+`	همانند قبلی، اما با برتری 0 برای 1-9.
`m`	اگر نشانه غیر تحت اللفظی قبلی ساعت بود یا علامت بعدی ثانیه بود، نشان دهنده دقیقه در ساعت (بدون صفر اول) است. در غیر این صورت، ماه سال را به عنوان یک عدد (بدون صفر اول) نشان می دهد.
`M`	ماه سال بدون 0 پیشرو. از این نشانه برای بیان صریح یک ماه، به جای یک دقیقه، در الگوی خود استفاده کنید.
`mm`	همان `m` ، اما با 0 پیشرو برای هر دو مورد.
`MM`	ماه سال با 0 پیشرو. از این نشانه برای بیان صریح یک ماه، به جای یک دقیقه، در الگوی خود استفاده کنید.
`mmm`	مخفف ماه سه حرفی (به عنوان مثال، "فوریه").
`mmmm`	نام ماه کامل `mmmmmm+` نیز با این مطابقت دارد.
`mmmmm`	حرف اول ماه (به عنوان مثال، "ج" برای ژوئن).
`s`	ثانیه در دقیقه بدون 0 برتری.
`ss`	ثانیه در دقیقه با 0 برتری.
`[h+]`	تعداد ساعات سپری شده در یک مدت زمان. تعداد حروف نشان‌دهنده حداقل تعداد ارقام است (0s اول را اضافه می‌کند).
`[m+]`	تعداد دقیقه های سپری شده در یک مدت زمان. تعداد حروف نشان‌دهنده حداقل تعداد ارقام است (0s اول را اضافه می‌کند).
`[s+]`	تعداد ثانیه های سپری شده در یک مدت زمان. تعداد حروف نشان‌دهنده حداقل تعداد ارقام است (0s اول را اضافه می‌کند).
`d`	روز ماه، بدون صفر اول برای اعداد کمتر از 10.
`dd`	روز ماه، با صفر اول برای اعداد کمتر از 10.
`ddd`	روز هفته، مخفف سه حرفی (به عنوان مثال، "Mon").
`dddd+`	روز هفته، نام کامل.
`y`	سال 2 رقمی
`yy`	سال 2 رقمی
`yyy`	سال 4 رقمی
`yyyy+`	سال 4 رقمی
`a/p`	"a" را برای AM و "p" را برای PM نمایش می دهد. همچنین ساعت ها را به قالب 12 ساعته تغییر می دهد. اگر حرف نشانه بزرگ باشد، خروجی نیز خواهد بود.
`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`	4:08:53.53 p
`hh:mm A/P".M."`	04:08 بعد از ظهر
`yyyy-mm-dd`	05/04/2016
`mmmm d \[dddd\]`	5 آوریل [سه شنبه]
`h PM, ddd mmm dd`	4 بعد از ظهر، سه شنبه 05 آوریل
`dddd, m/d/yy at h:mm`	سه شنبه 16/04/16 ساعت 16:08
الگوهای زمان سپری شده	`3 hours, 13 minutes, 41.255 seconds`
`[hh]:[mm]:[ss].000`	03:13:41.255
`[mmmm]:[ss].000`	0193:41.255

الگوهای قالب اعداد

الگوی قالب عددی رشته‌ای از زیررشته‌های نشانه است که وقتی تجزیه می‌شوند، با نمایش‌های عددی مربوطه جایگزین می‌شوند. یک الگوی قالب اعداد می تواند حداکثر از چهار بخش تشکیل شده باشد که با نقطه ویرگول از هم جدا شده اند، که قالب های جداگانه مورد استفاده برای اعداد مثبت، اعداد منفی، صفر و متن (به ترتیب) را مشخص می کند:

[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` " ارائه می کند.
`?`	نشان دهنده یک رقم در عدد است. اگر رقم 0 ناچیز باشد، به صورت فاصله نمایش داده می شود. این اغلب برای تراز کردن نقطه اعشار در یک ستون هنگام استفاده از فونت های با عرض ثابت استفاده می شود. مثلا قالب عددی `???.???` عدد 12.4 را به صورت: " `12.4` " نشان می دهد.
`.`	نقطه اول نشان دهنده نقطه اعشار در عدد است. دوره های بعدی به صورت تحت اللفظی ارائه می شوند. اگر یک نقطه اعشار را در قالب قرار دهید، همیشه حتی برای اعداد کامل ارائه می شود. به عنوان مثال، `#0.#` عدد 3 را به صورت " `3.` " نمایش می دهد.
`%`	به صورت تحت اللفظی ظاهر می شود اما همچنین باعث می شود اعداد موجود قبل از رندر شدن در 100 ضرب شوند تا درصدها خواناتر شوند. به عنوان مثال، فرمت عدد `#%` عدد 0.25 را به صورت " `25%` " ارائه می کند.
`,`	اگر بین کاراکترهای دو رقمی ( `0` ، `#` ، یا `?` ) ظاهر شود، کل عدد را با جداکننده‌های گروه‌بندی (گروه‌بندی به هزاران) ارائه می‌کند. اگر از کاراکترهای رقمی پیروی کند، ارقام را در هر کاما یک هزار مقیاس می کند (به عنوان مثال، فرمت `#0.0,,` عدد 12200000 را به صورت `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 گرد می‌شود). `/` با قالب علمی یا قالبی که اعشار در آن وجود دارد سازگار نیست.
`*`	این برای سازگاری با فرمت های شماره مایکروسافت اکسل گنجانده شده است. در حال حاضر نادیده گرفته شده است.
`_`	علامت زیر خط از کاراکتر بعدی می گذرد و یک فاصله نمایش می دهد. این برای ردیف کردن قالب‌های اعدادی که مقدار منفی با پرانتز احاطه شده است استفاده می‌شود.
`\`	با کاراکتر بعدی به عنوان یک ارزش تحت اللفظی برخورد می کند و معنای خاصی که ممکن است داشته باشد ندارد. برای مثال، فرمت اعداد `\#0` عدد 10 را به صورت " `#10` " ارائه می کند.
`"text"`	هر متنی را که داخل علامت نقل قول است به صورت تحت اللفظی نمایش می دهد.
`@`	اگر سلول دارای ورودی متن باشد، متن خام را برای سلول درج می کند. با هیچ یک از کاراکترهای خاص دیگر سازگار نیست و برای مقادیر عددی (که به صورت فرمت عمومی نمایش داده می شوند) نمایش داده نمی شود.
`$ - + ( ) : space`	Sheets با این کاراکترها به صورت واقعی رفتار می کند و آنها را بدون تغییر نمایش می دهد.

دستورالعمل های متا

علاوه بر این، هر یک از بخش‌های قالب می‌توانند دستورالعمل‌های متا اختیاری، محصور در کاراکترهای [] داشته باشند که قبل از قالب قرار می‌گیرند و دستورالعمل‌های اضافی را ارائه می‌دهند. دو نوع دستور متا وجود دارد و یک بخش مشخص می تواند از هر دو استفاده کند:

دستورالعمل توضیحات

[ condition ] مقایسه پیش فرض مثبت، منفی یا صفر بخش را با عبارت شرطی دیگری جایگزین می کند. برای مثال، [<100]”Low”;[>1000]”High”;000 کلمه "Low" را برای مقادیر زیر 100، "High" برای مقادیر بالاتر از 1000، و یک عدد سه رقمی (با 0های ابتدایی) ترجمه می‌کند. برای هر چیزی در این بین شرایط را فقط می توان برای دو زیرفرم اول اعمال کرد و اگر یک عدد با بیش از یک مطابقت داشت، از اولین مورد مطابقت استفاده می کند. اگر قالب سومی وجود داشته باشد، برای "همه چیز دیگر" استفاده می شود، در غیر این صورت اگر عددی با هر یک از قالب ها مطابقت نداشته باشد، به عنوان تمام "# ها" که عرض سلول را پر می کنند، ارائه می شود. اگر وجود داشته باشد، فرمت چهارم همیشه برای متن استفاده می شود.

[ Color ] or [ Color# ] باعث می شود هر مقداری که این قالب فرعی ارائه می دهد با رنگ متن داده شده ظاهر شود. مقادیر معتبر برای Color سیاه، آبی، فیروزه ای، سبز، سرخابی، قرمز، سفید یا زرد هستند. مقادیر معتبر برای "#" در Color# 1-56 است (این پالت رنگ لیستی از رنگ های مربوط به هر عدد را نشان می دهد). رنگ‌های قالب اعداد، رنگ‌های وارد شده توسط کاربر در سلول را نادیده می‌گیرند، اما رنگ‌های تنظیم‌شده با قالب‌بندی شرطی را لغو نکنید.

دستورالعمل	توضیحات
`[ condition ]`	مقایسه پیش فرض مثبت، منفی یا صفر بخش را با عبارت شرطی دیگری جایگزین می کند. برای مثال، `[<100]”Low”;[>1000]”High”;000` کلمه "Low" را برای مقادیر زیر 100، "High" برای مقادیر بالاتر از 1000، و یک عدد سه رقمی (با 0های ابتدایی) ترجمه می‌کند. برای هر چیزی در این بین شرایط را فقط می توان برای دو زیرفرم اول اعمال کرد و اگر یک عدد با بیش از یک مطابقت داشت، از اولین مورد مطابقت استفاده می کند. اگر قالب سومی وجود داشته باشد، برای "همه چیز دیگر" استفاده می شود، در غیر این صورت اگر عددی با هر یک از قالب ها مطابقت نداشته باشد، به عنوان تمام "# ها" که عرض سلول را پر می کنند، ارائه می شود. اگر وجود داشته باشد، فرمت چهارم همیشه برای متن استفاده می شود.
`[ 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	`#,###`	12000
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]_(@_)`	1234 1234 0.0 MyText
1005 32 527	`[>1000]"HIGH";[Color43][<=200]"LOW";0000`	بالا LOW 0527