# today 스크립트 및 차트 함수
이 함수는 UTC 시간을 기준으로 평가된 현재 날짜를 반환합니다. 이 함수는 `DateFormat` 시스템 변수 서식으로 값을 반환합니다.
구문:
today([ timer\_mode])
반환 데이터 유형: 이중
`today()` 함수는 로드 스크립트 또는 차트 개체에서 사용할 수 있습니다.
기본 `timer_mode` 값은 1입니다.
인수
| 인수 | 설명 |
| --- | --- |
| timer\_mode | 다음과 같은 값을 가질 수 있습니다.
0(데이터 로드가 마지막으로 완료된 날짜)
1(함수 호출 날짜)
2 (응용 프로그램이 열린 날짜)
정보 메모로드 스크립트에서 이 함수를 사용하면 timer\_mode=0이 마지막으로 데이터 로드가 완료된 날짜가 되지만 timer\_mode=1은 현재 데이터 로드 날짜를 제공합니다. |
함수 예
| timer\_mode 값 | 로드 스크립트에서 사용된 경우 결과 | 차트 개체에서 사용된 경우 결과 |
| --- | --- | --- |
| 0 | 최신 데이터 다시 로드 이전에 마지막으로 성공한 데이터 다시 로드의 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. | 최신 데이터를 다시 로드한 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. |
| 1 | 최신 데이터를 다시 로드한 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. | 함수 호출의 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. |
| 2 | 응용 프로그램에서 사용자의 세션이 시작된 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. 사용자가 스크립트를 다시 로드하지 않으면 업데이트되지 않습니다. | 응용 프로그램에서 사용자의 세션이 시작된 날짜를 `DateFormat` 시스템 변수 형식으로 반환합니다. 이는 새 세션이 시작되거나 응용 프로그램의 데이터가 다시 로드되면 새로 고쳐집니다. |
## today를 사용하는 경우
`today()` 함수는 일반적으로 표현식 내에서 구성 요소로 사용됩니다. 예를 들어, 현재 날짜까지 한 달 동안 누적된 이자를 계산하는 데 사용할 수 있습니다.
다음 표는 `timer_mode` 인수에 대해 다른 값이 주어졌을 때 `today()` 함수에서 반환된 결과에 대한 설명을 제공합니다.
## 국가별 설정
달리 지정하지 않는 한 이 항목의 예에서는 다음 날짜 형식을 사용합니다: MM/DD/YYYY. 날짜 형식은 데이터 로드 스크립트의 `SET DateFormat` 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다. 자세한 내용은 [응용 프로그램 및 스크립트에 대한 지역 설정 수정](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm)를 참조하십시오.
응용 프로그램의 기본 지역 설정은 사용자 프로필을 기반으로 합니다. 이러한 국가별 형식 설정은 Qlik Cloud 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Cloud는 사용 중인 브라우저와 동일한 언어로 표시됩니다.
응용 프로그램 작성자인 경우 만든 응용 프로그램의 기본 지역을 설정할 수 있습니다. 자세한 내용은 [Qlik Cloud 분석에서 앱 및 스크립트 만들기를 위한 기본 지역 설정 지정](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting)을 참조하십시오.
## 예 1 – 로드 스크립트를 사용한 개체 생성
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### 로드 스크립트 및 결과
개요
다음 예에서는 `today()` 함수를 사용하여 세 개의 변수를 만듭니다. 각 변수는 `timer_mode` 옵션 중 하나를 사용하여 효과를 보여 줍니다.
변수가 목적을 나타내려면 스크립트를 다시 로드한 다음 24시간 후에 스크립트를 두 번째로 다시 로드합니다. 그러면 `today(0)` 및 `today(1)` 변수가 다른 값을 표시하여 목적을 올바르게 보여 줍니다.
로드 스크립트
```
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);
```
결과
데이터가 두 번째로 로드되면 아래 지침을 사용하여 3개의 텍스트 상자를 만듭니다.
먼저 이전에 로드된 데이터에 대한 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 개체에 다음 측정값을 추가합니다.
`=vPreviousDataLoad`
3. 모양 아래에서 Show titles를 선택하고 '이전 다시 로드 시간'이라는 제목을 개체에 추가합니다.
다음으로 현재 로드 중인 데이터에 대한 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 개체에 다음 측정값을 추가합니다.
`=vCurrentDataLoad`
3. 모양 아래에서 Show titles를 선택하고 '현재 다시 로드 시간'이라는 제목을 개체에 추가합니다.
응용 프로그램에서 사용자 세션이 시작된 시간을 표시할 최종 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 개체에 다음 측정값을 추가합니다.
`=vApplicationOpened`
3. 모양 아래에서 Show titles를 선택하고 '사용자 세션 시작됨'이라는 제목을 개체에 추가합니다.
로드 스크립트에서 `today()` 함수를 사용하여 만들어진 변수 다이어그램
로드 스크립트에서 `today()` 함수를 사용하여 만들어진 변수 다이어그램
로드 스크립트에서 `today()`today() 함수를 사용하여 만들어진 변수 다이어그램 
위 이미지는 만들어진 각 변수 값에 대한 예를 보여 줍니다. 예를 들어 값은 다음과 같을 수 있습니다.
* 이전 다시 로드 시간: 06/22/2022
* 현재 다시 로드 시간: 06/23/2022
* 사용자 세션 시작: 06/23/2022
## 예 2 – 로드 스크립트 없이 개체 생성
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### 로드 스크립트 및 차트 표현식
개요
다음 예에서는 `today()` 함수를 사용하여 세 개의 차트 개체를 만듭니다. 각 차트 개체는 `timer_mode` 옵션 중 하나를 사용하여 효과를 보여 줍니다.
이 예에는 로드 스크립트가 없습니다.
결과
데이터가 두 번째로 로드되면 세 개의 텍스트 상자를 만듭니다.
먼저 최신 데이터 다시 로드를 위한 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 다음 측정값을 추가합니다.
`=today(0)`
3. 모양에서 제목 표시를 선택하고 개체에 '최신 데이터 다시 로드'라는 제목을 추가합니다.
다음으로, 현재 시간을 표시할 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 다음 측정값을 추가합니다.
`=today(1)`
3. 모양에서 제목 표시를 선택하고 개체에 '현재 시간'이라는 제목을 추가합니다.
사용자의 앱 세션이 언제 시작되었는지 표시할 마지막 텍스트 상자를 만듭니다.
다음과 같이 하십시오.
1. 텍스트 및 이미지 차트 개체를 사용하여 텍스트 상자를 만듭니다.
2. 다음 측정값을 추가합니다.
`=today(2)`
3. 모양에서 제목 표시를 선택하고 개체에 '사용자 세션 시작'이라는 제목을 추가합니다.
로드 스크립트 없이 `today()` 함수를 사용하여 만들어진 개체 다이어그램
로드 스크립트 없이 `today()` 함수를 사용하여 만들어진 개체 다이어그램
로드 스크립트 없이 `today()`today() 함수를 사용하여 만들어진 개체 다이어그램 
위 이미지는 만들어진 각 개체에 대한 예시 값을 보여 줍니다. 예를 들어 값은 다음과 같을 수 있습니다.
* 최신 데이터 다시 로드: 06/23/2022
* 현재 시간: 06/23/2022
* 사용자 세션 시작: 06/23/2022
'최신 데이터 다시 로드' 차트 개체는 `timer_mode` 값 0을 사용합니다. 이는 데이터가 성공적으로 다시 로드된 마지막 시간의 타임스탬프를 반환합니다.
'현재 시간' 차트 개체는 `timer_mode` 값 1을 사용합니다. 이는 시스템 시계에 따라 현재 시간을 반환합니다. 시트 또는 개체를 새로 고치면 이 값이 업데이트됩니다.
'사용자 세션 시작' 차트 개체는 `timer_mode` 값 2를 사용합니다. 이는 응용 프로그램이 열리고 사용자의 세션이 시작된 시간에 대한 타임스탬프를 반환합니다.
## 예 3 – 시나리오
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### 로드 스크립트 및 차트 표현식
개요
데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.
로드 스크립트에는 다음이 포함됩니다.
* `Loans`라는 테이블에 로드되는 대출 잔액 집합이 포함된 데이터 집합.
* 대출 ID, 월초 잔액, 각 대출에 연간 부과되는 단순 이자율에 대한 필드가 있는 테이블 데이터입니다.
최종 사용자는 대출 ID별로 해당 월부터 현재까지 각 대출에 대해 발생한 현재 이자를 표시하는 차트 개체를 원합니다. 응용 프로그램은 일주일에 한 번만 다시 로드되지만 사용자는 개체 또는 응용 프로그램이 새로 고쳐질 때마다 결과가 새로 고쳐지기를 원합니다.
로드 스크립트
```
Loans:
Load
*
Inline
[
loan_id,start_balance,rate
8188,$10000.00,0.024
8189,$15000.00,0.057
8190,$17500.00,0.024
8191,$21000.00,0.034
8192,$90000.00,0.084
];
```
결과
다음과 같이 하십시오.
1. 데이터를 로드하고 시트를 엽니다. 새 테이블을 만듭니다.
2. 다음 필드를 차원으로 추가합니다.
* `loan_id`
* `start_balance`
3. 다음으로, 누적 이자를 계산하는 측정값을 만듭니다.
`=start_balance*(rate*(today(1)-monthstart(today(1)))/365)`
4. 측정값의 숫자 형식을 화폐로 설정합니다.
결과 테이블
| loan\_id | 시작 잔액 | =시작\_잔액\*(이자율\*(오늘(1)-월초(오늘(1)))/365) |
| --- | --- | --- |
| 8188 | $10000.00 | $16.44 |
| 8189 | $15000.00 | $58.56 |
| 8190 | $17500.00 | $28.77 |
| 8191 | $21000.00 | $48.90 |
| 8192 | $90000.00 | $517.81 |
`today()` 함수를 사용하여 오늘 날짜를 유일한 인수로 반환하는 `monthstart()` 함수는 현재 월의 시작 날짜를 반환합니다. `today()` 함수를 다시 사용하여 현재 날짜에서 해당 결과를 빼면 이 표현식은 이번 달에 지금까지 경과한 일 수를 반환합니다.
그런 다음 이 값에 이자율을 곱하고 365로 나누어 이 기간 동안 발생한 유효 이자율을 반환합니다. 그런 다음 결과에 대출의 시작 잔액을 곱하여 이번 달 지금까지 발생한 이자를 반환합니다.
표현식 내부의 `today()` 함수에서 값 1이 `timer_mode` 인수로 사용되므로 차트 개체를 새로 고칠 때마다(응용 프로그램 열기, 페이지 새로 고침, 시트 간 이동 등) 반환된 날짜는 현재 날짜이며 그에 따라 결과가 새로 고쳐집니다.