날짜 및 숫자 형식

날짜-시간 및 숫자 형식을 사용하면 데이터가 시트에 표시되는 방식을 제어할 수 있습니다. Google 시트는 몇 가지 일반적인 형식을 선택할 수 있지만, 나만의 형식을 정의합니다.

Sheets UI에서는 형식 > 숫자 메뉴 Sheets API에서는 spreadsheets.batchUpdate 메서드를 호출하여 UpdateCellsRequest 또는 RepeatCellRequest:

이 페이지에서는 새 날짜 및 숫자 형식 패턴을 정의하는 방법을 설명합니다. 포함할 수 있습니다. 샘플 범위의 커스텀 날짜/시간 또는 십진수 형식 설정 은 API를 사용하여 형식 패턴을 설정하는 방법을 보여줍니다. 실제 렌더링은 형식의 형식은 스프레드시트의 locale에 따라 다릅니다. 이 가이드에서는 locale이 en_US입니다. 다음 항목을 실행하여 스프레드시트의 locale를 결정할 수 있습니다. SpreadsheetProperties spreadsheets.get 사용 요청을 수행합니다.

날짜 및 정보 시간 값

스프레드시트는 다른 대부분의 스프레드시트 애플리케이션과 마찬가지로 날짜 및 시간 값을 십진수입니다. 이를 통해 공식에서 연산을 수행하여 일 또는 주 수를 늘리거나 두 개의 날짜와 시간을 더하거나 빼고, 다른 유사한 작업을 수행합니다.

Sheets는 에포크 날짜 바로 스프레드 시트에서 흔히 사용됩니다. 값의 정수 부분 (소수점의 왼쪽)은 1899년 12월 30일 이후의 일수를 셉니다. 분수 부분 (소수점의 오른쪽)은 하루의 분수로 시간을 계산합니다. 대상 예를 들어 1900년 1월 1일 정오는 2.5입니다. 2일 후이므로 2입니다. 1899년 12월 30일, 정오가 반나절이므로 0.5입니다. 1900년 2월 1일 오후 3시 33.625입니다.

스프레드시트에서는 1900년을 윤년이 아닌 평년으로 올바르게 처리합니다.

날짜 및 시간 형식 패턴

날짜-시간 형식 패턴은 파싱 시 해당 날짜-시간 요소 (예: 월 또는 시간).

날짜 및 시간 형식 토큰

다음 표는 날짜-시간에 사용할 수 있는 토큰 하위 문자열을 정의합니다. 형식 패턴을 따릅니다. + 문자는 이전 문자가 표시될 수 있음을 나타냅니다. 패턴과 일치함을 확인합니다. 아래 표는 리터럴로 처리되며 변경 없이 출력됩니다.

토큰	설명
h	시간대입니다. 다음에 따라 12시간 및 24시간 형식 간에 전환합니다. 문자열에 AM 또는 PM 표시가 있는지 여부입니다.
hh+	이전과 동일하지만 1~9 앞에 0이 붙습니다.
m	리터럴이 아닌 이전 토큰이 시간거나 이후 토큰이 초, 시간에서 분을 나타냅니다 (앞에 0 없음). 그렇지 않으면 월을 숫자로 나타냅니다 (선행 0 없음).
M	월(앞에 0이 없는)입니다. 이 토큰을 사용하여 패턴에 1분이 아닌 1개월을 명시하세요.
mm	m와 동일하지만 두 경우 모두 앞에 0이 붙습니다.
MM	월(앞에 0이 붙은) 이 토큰을 사용하여 패턴에 1분이 아닌 1개월을 명시하세요.
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
yyy	4자리 연도
yyyy+
a/p	'a'를 표시합니다. AM, 'p' 시작하겠습니다. 또한 영업시간을 다음으로 변경 12시간 형식. 토큰 문자가 대문자이면 다음과 같이 출력됩니다. 있습니다.
am/pm	위와 같지만 'AM'을 표시합니다. 또는 'PM' 항상 합니다.
0	10분의 1초입니다. 다음 공식을 사용하여 정밀도를 두 자리로 높일 수 있습니다. 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	2016-04-05
mmmm d \[dddd\]	4월 5일 [화요일]
h PM, ddd mmm dd	4월 5일 화요일 오후 4시
dddd, m/d/yy at h:mm	2016년 4월 5일 화요일 16:08
경과 시간 패턴	3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000	03:13:41.255
[mmmm]:[ss].000	0193:41.255

숫자 서식 패턴

숫자 형식 패턴은 파싱될 때 숫자 표현으로 대체됩니다. 숫자 서식 패턴 최대 4개의 섹션으로 구성될 수 있으며, 각 섹션은 세미콜론으로 구분됩니다. 양수, 음수, 0 및 텍스트( 해당 주문):

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

한 형식에 4개의 섹션을 모두 포함할 필요는 없습니다. 하나만 포함하는 경우 섹션에서 이 형식이 모든 값에 사용됩니다. 두 섹션을 사용하면 첫 번째 0과 양수에 적용하고 두 번째 형식을 음수입니다. 3개의 섹션을 사용하면 포함, 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, # 또는 ?)를 사용하면 전체 숫자를 렌더링합니다. 천 단위로 구분할 수 있습니다. 만약 1, 000 단위로 숫자를 쉼표 (예: #0.0,, 형식은 12.2로 12,200,000개).
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 미만의 값은 '낮음', 1,000보다 큰 경우 '높음', 3자리 숫자 숫자 (앞에 0 포함)를 입력합니다. 조건은 첫 두 개의 하위 형식에 적용되고, 숫자가 2개 이상과 일치하면 일치하는 첫 번째 항목을 사용합니다. 세 번째 형식은 '기타 모든 것'에 사용되며, 숫자가 일치하지 않는 경우 형식에서는 모든 '#'이 셀 너비를 채우도록 렌더링됩니다. 일치하는 항목이 있는 경우 네 번째 형식은 항상 텍스트에 사용됩니다.
[Color] or [Color#]	이 하위 형식이 렌더링하는 모든 값이 지정할 수 있습니다. 유효한 Color 값은 Black입니다. 파란색, 녹청색, 녹색, 자홍색, 빨간색, 흰색 또는 노란색 '#'에 유효한 값 Color#의 값은 0&ndash1;56입니다 (이 값은 색상 팔레트 각 숫자에 해당하는 색상 목록을 표시합니다. 숫자 형식 색상 은 사용자가 입력한 색상보다 우선 적용되지만 조건부 서식으로 설정된 색상을 재정의합니다.

숫자 형식의 예

다음 표에는 몇 가지 예시 패턴과 해당하는 패턴이 나와 있습니다. 서식이 지정된 숫자 렌더링:

숫자	패턴	형식이 지정된 값
12345125	####.#	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