# today - 스크립트 및 차트 함수
이 함수는 현재 날짜를 반환합니다. 이 함수는 `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()` 함수는 일반적으로 표현식 내에서 구성 요소로 사용됩니다. 예를 들어, 현재 날짜까지 한 달 동안 누적된 이자를 계산하는 데 사용할 수 있습니다.
다음 표는 `timer_mode` 인수에 대해 다른 값이 주어졌을 때 `today()` 함수에서 반환된 결과에 대한 설명을 제공합니다.
## 국가별 설정
달리 지정하지 않는 한 이 항목의 예에서는 다음 날짜 형식을 사용합니다. YYYY/MM/DD. 날짜 형식은 데이터 로드 스크립트의 `SET DateFormat` 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다.
앱의 기본 국가별 설정은 Qlik Sense가 설치된 컴퓨터 또는 서버의 국가별 시스템 설정을 기반으로 합니다. 액세스하는 Qlik Sense 서버가 스웨덴으로 설정된 경우 데이터 로드 편집기는 날짜, 시간 및 통화에 대해 스웨덴 지역 설정을 사용합니다. 이러한 국가별 형식 설정은 Qlik Sense 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Sense는 사용 중인 브라우저와 동일한 언어로 표시됩니다.
## 예 1 – 로드 스크립트를 사용한 개체 생성
[](https://help.qlik.com/en-US/sense/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/sense/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/sense/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 | start\_balance | =start\_balance\*(rate\*(today(1)-monthstart(today(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` 인수로 사용되므로 차트 개체를 새로 고칠 때마다(응용 프로그램 열기, 페이지 새로 고침, 시트 간 이동 등) 반환된 날짜는 현재 날짜이며 그에 따라 결과가 새로 고쳐집니다.