Bu belgede, API isteğinize ekleyebileceğiniz yeni tarih ve sayı biçimi kalıplarının nasıl tanımlanacağı açıklanmaktadır.
Tarih-saat ve sayı biçimleri, verilerinizin bir sayfada nasıl göründüğünü kontrol etmenizi sağlar. Google E-Tablolar, arasından seçim yapabileceğiniz bazı sık kullanılan biçimler sunar. Ancak kendi biçimlerinizi de tanımlayabilirsiniz.
E-Tablolar kullanıcı arayüzünde, Biçim > Sayı menüsünü kullanarak hücrelere sayı ve tarih biçimleri uygulayabilirsiniz. Google Sheets API'de bu biçimleri, spreadsheets.batchUpdate yöntem çağrısını kullanarak UpdateCellsRequest veya RepeatCellRequest göndererek ayarlarsınız.
İstekte, bir NumberFormatType (ör. NUMBER, CURRENCY, PERCENT, DATE veya TIME) ve isteğe bağlı bir pattern dizesi belirterek NumberFormat nesnesini yapılandırırsınız. pattern parametresini atlarsanız E-Tablolar, e-tablonun locale değerine göre belirtilen type için varsayılan biçim kalıbını kullanır (örneğin, en_US içinde CURRENCY için $1,000.12).
Bir aralık için özel tarih/saat veya ondalık biçimi ayarlama örneğinde, Sheets API kullanılarak biçim kalıbının nasıl ayarlanacağı gösterilmektedir. Biçimin gerçekte nasıl oluşturulacağı,
e-tablonun locale değerine bağlıdır.
Bu belgede, locale değerinin en_US olduğu varsayılmaktadır. spreadsheets kaynağında spreadsheets.get yöntemini kullanarak SpreadsheetProperties nesnesini okuyarak bir e-tablonun locale değerini belirleyebilirsiniz.
Daha fazla örnek için Temel biçimlendirme ve Koşullu biçimlendirme bölümlerine bakın.
Tarih ve saat değerleri hakkında
E-Tablolar, diğer çoğu e-tablo uygulaması gibi tarih ve saat değerlerini ondalık değerler olarak ele alır. Bu sayede, formüllerde tarih ve saatler üzerinde aritmetik işlemler yapabilirsiniz. Örneğin, gün veya hafta sayısını artırabilir, iki tarih ve saati toplayabilir ya da çıkarabilir ve benzer işlemler yapabilirsiniz.
E-Tablolar, e-tablolarda yaygın olarak kullanılan bir başlangıç tarihi biçimi kullanır. Değerin tam sayı kısmı (ondalık işaretinin solunda), 30 Aralık 1899'dan sonraki günleri sayar. Kesirli kısım (ondalık işaretinin sağ tarafı), zamanı bir günün kesri olarak sayar. Örneğin, 1 Ocak 1900 öğle vakti 2.5, 2'dir. Çünkü 30 Aralık 1899'dan 2 gün sonradır ve öğle vakti yarım gün olduğu için 0.5'dir. 1 Şubat 1900, saat 15:00, 33.625 değerine karşılık gelir.
E-Tablolar, 1900 yılını artık yıl olarak değil, normal yıl olarak doğru şekilde değerlendirir. Tarih ve saat seri numaraları, saat dilimi farkını depolamaz. Bunun yerine, e-tablonun timeZone değerini temel alır. Bu değeri, spreadsheets.get yöntemini kullanarak SpreadsheetProperties nesnesinden okuyabilirsiniz.
Tarih ve saat biçimi kalıpları
Tarih-saat biçimi kalıbı, E-Tablolar'ın ayrıştırıldığında ilgili tarih-saat öğeleriyle (ay veya saat gibi) değiştirdiği alt dize jetonlarından oluşan bir dizedir.
Tarih ve saat biçimi jetonları
Aşağıdaki tabloda, tarih-saat biçimi kalıbında kullanabileceğiniz alt dize jetonları tanımlanmaktadır. + karakteri, önceki karakterin bir veya daha fazla kez görünebileceğini ve kalıpla eşleşmeye devam edebileceğini gösterir. E-Tablolar, bu tabloda listelenmeyen karakterleri değişmez değer olarak kabul eder ve bunları değiştirmeden gösterir.
| Jeton | Açıklama |
|---|---|
h |
Günün saati. Dizede ÖÖ veya ÖS göstergesinin bulunup bulunmadığına bağlı olarak 12 ve 24 saat biçimleri arasında geçiş yapar. |
hh+ |
Öncekiyle aynıdır ancak 1-9 için başında 0 bulunur. |
m |
Önceki değişmez olmayan jeton saatse veya sonraki saniyeyse saatteki dakikayı temsil eder (başında 0 olmadan). Aksi takdirde, yılın ayını sayı olarak (başında 0 olmadan) temsil eder. |
M |
Başında 0 olmadan yılın ayı. Kalıbınızda dakika yerine ayı açıkça belirtmek için bu jetonu kullanın. |
mm |
m ile aynıdır ancak her iki durumda da başta 0 bulunur. |
MM |
Başında 0 olan yılın ayı. Kalıbınızda dakika yerine açıkça bir ay belirtmek için bu jetonu kullanın. |
mmm |
Üç harfli ay kısaltması (örneğin, "Şub"). |
mmmm |
Ayın tam adı. mmmmmm+ da bu kurala uyuyor. |
mmmmm |
Ayın ilk harfi (örneğin, Haziran için "H"). |
s |
Başında 0 olmadan dakikanın saniyesi. |
ss |
Başında 0 olan dakika içindeki saniye. |
[h+] |
Bir süre içinde geçen saat sayısı. Harf sayısı, minimum basamak sayısını gösterir (başa 0 ekler). |
[m+] |
Bir süre içinde geçen dakika sayısı. Harf sayısı, minimum basamak sayısını gösterir (başa 0 ekler). |
[s+] |
Bir süre içinde geçen saniye sayısı. Harf sayısı, minimum basamak sayısını gösterir (başa 0 ekler). |
d |
Ayın günü (10'dan küçük sayılar için başında 0 olmadan). |
dd |
Ayın günü (10'dan küçük sayılar için başında 0 bulunur). |
ddd |
Haftanın günü, üç harfli kısaltma (ör. "Pzt"). |
dddd+ |
Haftanın günü, tam ad. |
y |
2 haneli yıl. |
yy |
|
yyy |
4 haneli yıl. |
yyyy+ |
|
a/p |
Öğleden önce için "a", öğleden sonra için "p" gösterir. Ayrıca saatleri 12 saat biçimine değiştirir. Jeton harfi büyükse çıkış da büyük harfle yazılır. |
am/pm |
Yukarıdakiyle aynıdır ancak "ÖÖ" veya "ÖS" gösterir ve her zaman büyük harfle yazılır. |
0 |
Saniyenin onda biri. Hassasiyeti 00 ile iki basamağa veya 000 ile üç basamağa (milisaniye) çıkarabilirsiniz. |
\ |
Bir sonraki karakteri değişmez değer olarak kabul eder ve sahip olabileceği özel anlamları yok sayar. |
"text" |
Tırnak işaretleri içindeki metni olduğu gibi gösterir. |
Tarih ve saat biçimi örnekleri
Tuesday, April 5, 2016, 4:08:53.528 PM tarih ve saati için aşağıdaki tabloda bazı örnek kalıplar ve bunlara karşılık gelen tarih-saat biçimlerinin görünümü yer almaktadır. Tablonun ikinci bölümünde, 3 hours, 13 minutes, 41.255 seconds geçen süre için geçen süre biçimlerine örnekler gösterilmektedir:
| Tarih-Saat Kalıpları | 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." |
16:08 |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 Nisan [Salı] |
h PM, ddd mmm dd |
5 Nisan Salı, 16:00 |
dddd, m/d/yy at h:mm |
5 Nisan 2016 Salı, 16:08 |
| Geçen Süre Modelleri | 3 hours, 13 minutes, 41.255 seconds |
[hh] |
03 |
[mmmm] |
0193 |
[ss] |
11621 |
Sayı biçimi kalıpları
Sayı biçimi kalıbı, ayrıştırıldığında E-Tablolar'ın karşılık gelen sayı temsilleriyle değiştirdiği jeton alt dizelerinden oluşan bir dizedir. Sayı biçimi kalıbı, noktalı virgülle ayrılmış en fazla dört bölümden oluşabilir. Bu bölümler, pozitif sayılar, negatif sayılar, sıfır ve metin için kullanılan ayrı biçimleri (bu sırayla) tanımlar:
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Bir biçime dört bölümün tamamını eklemeniz gerekmez. Yalnızca bir bölüm eklerseniz E-Tablolar tüm değerler için bu biçimi kullanır. İki bölüm kullanıldığında ilk biçim sıfır ve pozitif sayılara, ikinci biçim ise negatif sayılara uygulanır. Üç bölüm kullanıldığında pozitif, negatif ve sıfır sayılar için ayrı biçimler tanımlanır. Örneğin:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
Ancak iki veya daha fazla bölüm varsa ve son bölüm metin biçimindeyse E-Tablolar bu bölümü metin biçimi olarak değerlendirir ve diğer bölümler bir bölüm eksikmiş gibi davranır. Bu nedenle, son metin biçimini ekleyerek aşağıdaki gibi biçimleri tanımlamak mümkündür:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
Bir biçimin bölümlere ayrılması diğer ayrıştırma işlemlerinden önce gerçekleşir. Bu nedenle, bölümlerden biri olarak bir tarih veya saat biçimi eklemek mümkündür (ancak bu sınırlı bir kullanıma sahiptir).
Sayı biçimi jetonları
Aşağıdaki tabloda, bir biçim bölümünde değerlerin nasıl temsil edileceğini tanımlamak için kullanabileceğiniz alt dize jetonları tanımlanmaktadır.
| Jeton | Açıklama |
|---|---|
0 |
Sayıdaki bir basamağı temsil eder. Basamak önemsiz bir 0 ise 0 olarak oluşturulur. Örneğin, 00.0 sayı biçimi, 3 sayısını "03.0" olarak gösterir. |
# |
Sayıdaki bir basamağı temsil eder. Rakam önemsiz bir 0 ise oluşturulmaz. Örneğin, ##0 sayı biçimi, 12 sayısını "12" olarak gösterir. |
? |
Sayıdaki bir basamağı temsil eder. Rakam önemsiz bir 0 ise boşluk olarak gösterilir. Bu genellikle, sabit genişlikli yazı tipleri kullanılırken bir sütundaki ondalık işaretini hizalamak için kullanılır. Örneğin, ???.??? sayı biçimi 12,4 sayısını şu şekilde oluşturur: " 12.4 ". |
. |
İlk nokta, sayıdaki ondalık işaretini temsil eder. Sonraki noktalar değişmez değer olarak oluşturulur. Biçime ondalık işareti eklerseniz tam sayılar için bile her zaman gösterilir. Örneğin,
#0.#, 3 sayısını "3." olarak gösterir. |
% |
Değişmez değer olarak görünür ancak mevcut sayıların, yüzdelerin daha kolay okunabilmesi için oluşturulmadan önce 100 ile çarpılmasına da neden olur. Örneğin, #% sayı biçimi, 0,25 sayısını "25%" olarak gösterir. |
, |
İki basamaklı karakterler (0, # veya ?) arasında görünüyorsa tüm sayıyı gruplandırma ayırıcılarıyla (binlik gruplar halinde) oluşturur. Rakam karakterlerinden sonra gelirse rakamları virgül başına bin kat ölçeklendirir (örneğin, #0.0,, biçimi 12.200.000 sayısını 12.2 olarak gösterir). |
E- |
Sayıyı bilimsel biçimde oluşturur. E işaretinin solundaki biçimlendirme üs olmayan kısım için, E işaretinin sağındaki biçimlendirme ise üs kısmı için kullanılır. E+, pozitif üsler için + işaretini gösterir. E- yalnızca negatif üsler için bir işaret gösterir. Küçük harf kullanılıyorsa çıkış e da küçük harfle yazılır.
Örneğin, ##0.00#E+## sayı biçimi, 0,0000001 sayısını "100.00E-9" olarak oluşturur. |
E+ |
|
e- |
|
e+ |
|
/ |
İki basamaklı karakterler (0, # veya ?) arasında görünüyorsa bu basamak gruplarını kesirli biçim olarak değerlendirir. Örneğin, 0 #/# sayı biçimi 23,25 sayısını 23 1/4 olarak gösterir. Payda, tam sayı da olabilir. Bu durumda, tam sayı payda olarak kullanılır. 0 #/8 sayı biçimi,
23,25 sayısını 23 2/8 olarak gösterir. Pay 0 olursa kesir kısmı oluşturulmaz. 0 #/3 sayı biçimine sahip 23,1 sayısı, yalnızca 23 olarak oluşturulur (çünkü 0,1, 0/3'e yuvarlanır). /, bilimsel biçimle veya ondalık işareti içeren bir biçimle uyumlu değil. |
* |
Microsoft Excel sayı biçimleriyle uyumluluk için dahil edilmiştir. E-Tablolar bu jetonu yoksayar. |
_ |
Sonraki karakteri atlar ve bir boşluk oluşturur. Negatif değerin parantez içinde olduğu sayı biçimlerini hizalamak için bu jetonu kullanın. |
\ |
Bir sonraki karakteri değişmez değer olarak kabul eder ve sahip olabileceği özel anlamları yok sayar. Örneğin, \#0 sayı biçimi, 10 sayısını "#10" olarak gösterir. |
"text" |
Tırnak işaretleri içindeki metni olduğu gibi gösterir. |
@ |
Hücrede metin girişi varsa hücrenin ham metnini ekler. Diğer özel karakterlerin hiçbiriyle uyumlu değildir ve sayısal değerler için gösterilmez (genel biçim olarak gösterilir). |
$ - + ( ) : space |
E-Tablolar, bu karakterleri ve yaygın para birimi simgelerini ($, €, £ ve ¥ gibi) değişmez değer olarak kabul eder ve değiştirmeden gösterir. |
Meta talimatlar
Ayrıca, biçim bölümlerinin her birinde, biçimden önce gelen ve ek talimatlar sağlayan, [] karakterleri içine alınmış isteğe bağlı meta talimatlar bulunabilir:
| Talimat | Açıklama |
|---|---|
[condition] |
Bölümün varsayılan pozitif, negatif veya sıfır karşılaştırmasını başka bir koşullu ifadeyle değiştirir. Örneğin,
[<100]"Low";[>1000]"High";000 100'ün altındaki değerler için "Düşük", 1.000'in üzerindeki değerler için "Yüksek" ve bu ikisi arasındaki değerler için üç basamaklı bir sayı (başında 0'lar olan) oluşturur. Koşulları yalnızca ilk iki alt biçime uygulayabilirsiniz. Bir sayı birden fazla alt biçimle eşleşirse E-Tablolar ilk eşleşmeyi kullanır. Üçüncü bir biçim varsa E-Tablolar bunu "diğer her şey" için kullanır. Aksi takdirde, bir sayı her iki biçimle de eşleşmezse E-Tablolar, hücre genişliği boyunca tüm "#" karakterlerini oluşturur. Varsa dördüncü biçim her zaman metin için kullanılır. |
[Color] or [Color#] |
Bu alt biçimin oluşturduğu tüm değerlerin, belirtilen metin rengiyle görünmesine neden olur. Color için geçerli değerler: Siyah, Mavi, Camgöbeği, Yeşil, Macenta, Kırmızı, Beyaz veya Sarı.
Color# içindeki "#" için geçerli değerler 1 ile 56 arasındadır. Sayı biçimi renkleri, hücreye kullanıcı tarafından girilen renkleri geçersiz kılar ancak koşullu biçimlendirme tarafından ayarlanan renkleri geçersiz kılmaz. Bu renk paleti, her sayıya karşılık gelen renklerin listesini gösterir. Bu işlevler, Microsoft Excel'deki ColorIndex özelliğini temel alır. |
[$currency] |
Belirtilen para birimi simgesini veya kodunu dize olarak gösterir (ör. [$€]#,##0.00 veya [$CAD]#,##0.00). Kısa çizgiden sonra isteğe bağlı bir yerel ayar kodu (ör. [$CAD-1009]) eklerseniz E-Tablolar yerel ayar kodunu yoksayar. |
Sayı biçimi örnekleri
Aşağıdaki tabloda bazı örnek kalıplar ve bunlara karşılık gelen biçimlendirilmiş sayıların görünümü yer almaktadır:
| Sayı | Kalıp | Biçimlendirilmiş Değer |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12,34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5,125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12.000 |
| 1234.56 -1234.56 |
$#,##0.00;($#,##0.00) |
1.234,56 ABD doları (1.234,56 ABD doları) |
| 1230000 | 0.0,,"M" |
1,2 Mn |
| 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 |
YÜKSEK DÜŞÜK 0527 |