이 페이지는 Cloud Translation API를 통해 번역되었습니다.

날짜 및 숫자 형식

날짜-시간 및 숫자 서식을 사용하면 데이터가 시트에 표시되는 방식을 관리할 수 있습니다. Google Sheets에서 제공하는 일반적인 서식 중에서 선택할 수 있으며, 직접 서식을 정의할 수도 있습니다.

Sheets UI에서는 Format > Number 메뉴를 사용하여 숫자 및 날짜 서식을 셀에 적용합니다. Sheets API에서는 spreadsheets.batchUpdate 메서드 호출을 사용하여 이러한 형식을 설정하고 UpdateCellsRequest 또는 RepeatCellRequest를 전송합니다.

이 페이지에서는 API 요청에 포함할 수 있는 새로운 날짜 및 숫자 서식 패턴을 정의하는 방법을 설명합니다. 특정 범위에 대해 사용자 지정 날짜시간 또는 십진수 서식 설정 샘플은 API를 사용하여 서식 패턴을 설정하는 방법을 보여줍니다. 형식의 실제 렌더링은 스프레드시트의 locale에 따라 다릅니다. 이 가이드에서는 locale가 en_US이라고 가정합니다. spreadsheets.get 요청으로 SpreadsheetProperties를 읽으면 스프레드시트의 locale를 확인할 수 있습니다.

날짜 및 시간 값 정보

Sheets는 다른 대부분의 스프레드시트 애플리케이션과 마찬가지로 날짜 및 시간 값을 십진수 값으로 처리합니다. 이렇게 하면 수식에 있는 날짜/시간에 대해 산술 연산을 수행하고, 일 또는 주를 증가시키고, 두 날짜/시간을 더하거나 빼고, 기타 유사한 작업을 수행할 수 있습니다.

Sheets에서는 스프레드시트에 흔히 사용되는 시점 날짜 형식을 사용합니다. 값의 정수 부분(소수점의 왼쪽)은 1899년 12월 30일 이후의 일수를 카운트합니다. 분수 부분 (소수점의 오른쪽)은 하루를 분수로 표기한 형식으로 시간을 나타냅니다. 예를 들어 1900년 1월 1일 정오는 2.5, 2(1899년 12월 30일로부터 2일 후) 및 0.5(정오는 하루의 절반)입니다. 1900년 2월 1일 오후 3시는 33.625입니다.

Sheets에서는 1900년을 윤년이 아닌 평년으로 처리합니다.

날짜 및 시간 형식 패턴

날짜-시간 형식 패턴은 파싱 시 해당 날짜-시간 요소 (예: 월 또는 시간)와 대체되는 토큰 하위 문자열의 문자열입니다.

날짜 및 시간 형식 토큰

다음 표에서는 날짜-시간 서식 패턴에 사용할 수 있는 토큰 하위 문자열을 정의합니다. + 문자는 이전 문자가 한 번 이상 나타날 수 있으며 패턴과 여전히 일치할 수 있음을 나타냅니다. 아래 표에 나열되지 않은 문자는 리터럴로 처리되며 변경 없이 출력됩니다.

토큰	설명
`h`	하루 중 시간입니다. 문자열에 AM 또는 PM 표시가 있는지 여부에 따라 12시간 및 24시간 형식이 전환됩니다.
`hh+`	이전과 동일하지만 1~9 앞에 0이 붙습니다.
`m`	리터럴이 아닌 이전 토큰이 '시간'이거나 후속 토큰이 '초'인 경우, 시간에서 분을 나타냅니다 (선행 0 없음). 그렇지 않은 경우 월을 숫자로 나타냅니다 (선행 0 없음).
`M`	앞에 0이 없는 월입니다. 이 토큰을 사용하여 패턴에서 분 대신 월을 명시합니다.
`mm`	`m`와 같지만 두 경우 모두 앞에 0이 붙습니다.
`MM`	연도의 월(앞에 0 표시) 이 토큰을 사용하여 패턴에서 분 대신 월을 명시합니다.
`mmm`	세 글자 월 약어 (예: 'Feb')
`mmmm`	월 이름입니다. `mmmmmm+`도 이에 해당합니다.
`mmmmm`	월의 첫 번째 글자 (예: 6월의 'J').
`s`	분에서 초를 나타내며 선행 0이 없음.
`ss`	1분 기준의 초(앞에 0 표시)
`[h+]`	시간 단위에서 경과된 시간입니다. 글자 수는 최소 자릿수를 나타냅니다 (선행 0 추가).
`[m+]`	시간 단위에서 경과된 분입니다. 글자 수는 최소 자릿수를 나타냅니다 (선행 0 추가).
`[s+]`	시간 단위에서 경과된 초입니다. 글자 수는 최소 자릿수를 나타냅니다 (선행 0 추가).
`d`	월의 날짜, 10보다 작은 경우 선행 0 없음
`dd`	월의 날짜, 10보다 작은 경우 선행 0 있음
`ddd`	요일, 세 글자 약어 (예: 'Mon')
`dddd+`	요일(전체 이름)입니다.
`y`	2자리 연도
`yy`	2자리 연도
`yyy`	4자리 연도
`yyyy+`	4자리 연도
`a/p`	AM은 'a', PM은 'p'로 표시합니다. 또한 시간을 12시간 형식으로 변경합니다. 토큰 글자가 대문자이면 출력도 대문자입니다.
`am/pm`	위와 동일하지만 그 대신 'AM' 또는 'PM'을 표시하며 항상 대문자입니다.
`0`	10분의 1초 `00`을 사용하여 정밀도를 2자리로 높이거나 `000`을 사용하여 3자리 (밀리초)로 높일 수 있습니다.
`\`	다음 문자를 리터럴 값으로 처리하며, 별다른 의미가 없을 수도 있습니다.
`"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."`	오후 4시 8분
`yyyy-mm-dd`	2016-04-05
`mmmm d \[dddd\]`	4월 5일 [화요일]
`h PM, ddd mmm dd`	4 PM, Tue Apr 05
`dddd, m/d/yy at h:mm`	2016년 4월 5일 화요일 16시 8분
경과 시간 패턴	`3 hours, 13 minutes, 41.255 seconds`
`[hh]:[mm]:[ss].000`	03:13:41.255
`[mmmm]:[ss].000`	0193:41.255

숫자 서식 패턴

숫자 서식 패턴은 파싱 시 해당 숫자 표시와 대체되는 토큰 하위 문자열의 문자열입니다. 숫자 서식 패턴은 세미콜론으로 구분된 최대 네 개의 섹션으로 구성될 수 있으며, 양수, 음수, 0, 텍스트에 사용되는 개별 서식을 정의합니다 (해당 순서대로).

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

한 서식에 네 개의 섹션을 모두 포함할 필요는 없습니다. 섹션을 하나만 포함하는 경우에는 그 서식이 모든 값에 사용됩니다. 두 개의 섹션을 사용하면 첫 번째 서식이 0과 양수에 적용되고 두 번째 서식이 음수에 적용됩니다. 세 개의 섹션을 사용하는 경우에는 양수, 음수, 숫자 0에 대해 개별 서식을 정의합니다. 예를 들면 다음과 같습니다.

[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,,` 형식은 숫자 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이 되면 분수 부분이 렌더링되지 않습니다. 숫자 서식이 `0 #/3`인 숫자 23.1은 `23`로 렌더링됩니다 (0.1이 0/3으로 반올림되므로). `/`은(는) 과학 서식이나 소수점 형식과 호환되지 않습니다.
`*`	Microsoft Excel 숫자 서식과의 호환성을 위해 포함되었습니다. 현재는 무시됩니다.
`_`	밑줄 토큰은 다음 문자를 건너뛰고 공백 하나를 렌더링합니다. 음수 값이 괄호로 둘러싸인 숫자 서식을 정렬하는 데 사용됩니다.
`\`	다음 문자를 리터럴 값으로 처리하며, 별다른 의미가 없을 수도 있습니다. 예를 들어 숫자 서식 `\#0`는 숫자 10을 '`#10`'로 렌더링합니다.
`"text"`	따옴표 안에 있는 텍스트는 무엇이든 리터럴로 표시합니다.
`@`	셀에 텍스트 입력이 있는 경우 셀의 원시 텍스트를 삽입합니다. 다른 특수 문자와 호환되지 않으며 숫자 값에는 표시되지 않습니다 (일반 형식으로 표시됨).
`$ - + ( ) : space`	Sheets에서는 이러한 문자를 리터럴로 취급하며 변경 없이 표시합니다.

메타 안내

또한 각 서식 섹션에는 [] 문자로 묶인 선택 항목인 메타 명령이 있을 수 있습니다. 이 명령은 서식 앞에 나오며 추가적인 명령을 제공합니다. 메타 명령 유형에는 두 가지가 있으며 지정된 섹션에서 두 가지를 모두 사용할 수 있습니다.

안내 설명

[condition] 섹션의 기본 양수, 음수 또는 0 비교를 다른 조건식으로 대체합니다. 예를 들어 [<100]”Low”;[>1000]”High”;000는 100 미만의 값에 대해 'Low'라는 단어를, 1,000을 초과하는 값에 대해 'High'라는 단어를, 그 사이의 값에 대해 세자리 숫자 (선행 0 포함)를 렌더링합니다. 조건은 처음 두 개의 하위 형식에만 적용할 수 있으며, 숫자가 둘 이상의 형식과 일치하면 일치하는 형식 중 첫 번째 형식이 사용됩니다. 세 번째 형식이 있는 경우 '기타 모든 항목'에 사용되며, 그렇지 않은 경우 숫자가 어느 형식과도 일치하지 않으면 모든 '#'이 셀 너비를 채우며 렌더링됩니다. 네 번째 형식이 있는 경우 항상 텍스트에 사용됩니다.

[Color] or [Color#] 이 하위 형식이 렌더링하는 모든 값이 지정된 텍스트 색상으로 표시됩니다. Color의 유효한 값은 Black, Blue, Cyan, Green, Magenta, Red, White 또는 Yellow입니다. Color#의 '#'에 유효한 값은 1~56입니다 (이 색상표는 각 숫자에 해당하는 색상 목록을 나타냅니다). 숫자 서식 색상은 사용자가 셀에 입력한 색상보다 우선하지만 조건부 서식으로 설정된 색상보다는 우선하지 않습니다.

안내	설명
`[condition]`	섹션의 기본 양수, 음수 또는 0 비교를 다른 조건식으로 대체합니다. 예를 들어 `[<100]”Low”;[>1000]”High”;000`는 100 미만의 값에 대해 'Low'라는 단어를, 1,000을 초과하는 값에 대해 'High'라는 단어를, 그 사이의 값에 대해 세자리 숫자 (선행 0 포함)를 렌더링합니다. 조건은 처음 두 개의 하위 형식에만 적용할 수 있으며, 숫자가 둘 이상의 형식과 일치하면 일치하는 형식 중 첫 번째 형식이 사용됩니다. 세 번째 형식이 있는 경우 '기타 모든 항목'에 사용되며, 그렇지 않은 경우 숫자가 어느 형식과도 일치하지 않으면 모든 '#'이 셀 너비를 채우며 렌더링됩니다. 네 번째 형식이 있는 경우 항상 텍스트에 사용됩니다.
`[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"`	120만
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`	높음 낮음 0527