날짜 및 시간 함수

CLEM은 날짜 및 시간을 나타내는 문자열 변수의 날짜/시간 저장 공간을 가진 필드를 처리하기 위한 함수 패밀리를 포함합니다. 사용하는 날짜 및 시간 형식은 각 스트림에 고유하며 스트림 특성 대화 상자에 지정됩니다. 날짜 및 시간 함수는 현재 선택된 형식에 따라 날짜 및 시간 문자열을 구문 분석합니다.

날짜에 두 자리만 사용하는 연도를 지정하는 경우(즉, 세기는 지정되지 않음) IBM® SPSS® Modeler은 스트림 특성 대화 상자에 지정되는 기본 세기를 사용합니다.

참고: 데이터 함수가 SQL 또는 IBM SPSS Analytic Server에 푸시백되는 경우, Analytic Server 데이터 소스를 뒤따르는 분기에서 해당 데이터 내 날짜 형식 문자열(to_date)은 SPSS Modeler 스트림에 지정된 날짜 형식과 매치해야 합니다.

표 1. CLEM 날짜 및 시간 함수
기능	결과	설명
`@TODAY`	문자열	스트림 특성 대화 상자에서 롤오버 일/분(O)을 선택하는 경우 이 함수는 현재 날짜를 현재 날짜 형식의 문자열로 리턴합니다. 두 자리 숫자 날짜 형식을 사용하고 롤오버 일/분(O)을 선택하지 않는 경우 이 함수는 현재 서버에서 $null$ 을 리턴합니다.
`to_time(ITEM)`	시간	지정된 필드의 저장 공간을 시간으로 변환합니다.
`to_date(ITEM)`	날짜	지정된 필드의 저장 공간을 날짜로 변환합니다.
`to_timestamp(ITEM)`	시간소인	지정된 필드의 저장 공간을 시간소인으로 변환합니다.
`to_datetime(ITEM)`	날짜/시간	지정된 필드의 저장 공간을 날짜, 시간 또는 시간소인 값으로 변환합니다.
`datetime_date(ITEM)`	날짜	숫자, 문자열 또는 시간소인의 날짜 값을 리턴합니다. 이는 숫자(초)를 날짜로 다시 변환할 수 있게 하는 유일한 함수입니다. `ITEM`이 문자열인 경우 현재 날짜 형식으로 문자열을 구문 분석하여 날짜를 생성합니다. 이 함수가 성공하려면 스트림 특성 대화 상자에 지정된 날짜 형식이 올바라야 합니다. `ITEM`이 숫자인 경우 기준 날짜(또는 에포크) 이후의 초 단위로 해석됩니다. 1일의 분수는 잘립니다. `ITEM`이 시간소인인 경우 시간소인의 날짜 부분이 리턴됩니다. `ITEM`이 날짜인 경우 변경되지 않고 리턴됩니다.
`date_before(DATE1, DATE2)`	Boolean	DATE1이 DATE2가 나타내는 날짜 또는 시간소인 이전의 날짜 또는 시간소인을 나타내는 경우 참 값을 리턴합니다. 그렇지 않으면 이 함수는 0 값을 리턴합니다.
`date_days_difference(DATE1, DATE2)`	정수	DATE1이 나타내는 날짜 또는 시간소인부터 DATE2가 나타내는 날짜 또는 시간소인까지의 시간(일)을 정수로 리턴합니다. DATE2가 DATE1 이전인 경우 이 함수는 음수를 리턴합니다.
`date_in_days(DATE)`	정수	기준 날짜부터 DATE가 나타내는 날짜 또는 시간소인까지의 시간(일)을 정수로 리턴합니다. DATE가 기준 날짜 이전인 경우 이 함수는 음수를 리턴합니다. 계산이 적절히 작동하려면 유효한 날짜를 포함시켜야 합니다. 예를 들어, 2001년 2월 29일을 날짜로 지정해서는 안 됩니다. 2001년은 윤년이 아니기 때문에 이 날짜가 존재하지 않습니다.
`date_in_months(DATE)`	실수	기준 날짜부터 DATE가 나타내는 날짜 또는 시간소인까지의 시간(월)을 실수로 리턴합니다. 이는 30.4375일을 1개월로 한 대략적인 숫자입니다. DATE가 기준 날짜 이전인 경우 이 함수는 음수를 리턴합니다. 계산이 적절히 작동하려면 유효한 날짜를 포함시켜야 합니다. 예를 들어, 2001년 2월 29일을 날짜로 지정해서는 안 됩니다. 2001년은 윤년이 아니기 때문에 이 날짜가 존재하지 않습니다.
`date_in_weeks(DATE)`	실수	기준 날짜부터 DATE가 나타내는 날짜 또는 시간소인까지의 시간(주)을 실수로 리턴합니다. 이는 7.0일을 1주로 합니다. DATE가 기준 날짜 이전인 경우 이 함수는 음수를 리턴합니다. 계산이 적절히 작동하려면 유효한 날짜를 포함시켜야 합니다. 예를 들어, 2001년 2월 29일을 날짜로 지정해서는 안 됩니다. 2001년은 윤년이 아니기 때문에 이 날짜가 존재하지 않습니다.
`date_in_years(DATE)`	실수	기준 날짜부터 DATE가 나타내는 날짜 또는 시간소인까지의 시간(년)을 실수로 리턴합니다. 이는 365.25일을 1년으로 한 대략적인 숫자입니다. DATE가 기준 날짜 이전인 경우 이 함수는 음수를 리턴합니다. 계산이 적절히 작동하려면 유효한 날짜를 포함시켜야 합니다. 예를 들어, 2001년 2월 29일을 날짜로 지정해서는 안 됩니다. 2001년은 윤년이 아니기 때문에 이 날짜가 존재하지 않습니다.
`date_months_difference (DATE1, DATE2)`	실수	DATE1이 나타내는 날짜 또는 시간소인부터 DATE2가 나타내는 날짜 또는 시간소인까지의 시간(월)을 실수로 리턴합니다. 이는 30.4375일을 1개월로 한 대략적인 숫자입니다. DATE2가 DATE1 이전인 경우 이 함수는 음수를 리턴합니다.
`datetime_date(YEAR, MONTH, DAY)`	날짜	주어진 YEAR, MONTH, DAY의 날짜 값을 생성합니다. 인수는 정수여야 합니다.
`datetime_day(DATE)`	정수	주어진 DATE 또는 시간소인의 날짜(일)를 리턴합니다. 결과는 1 - 31 범위의 정수입니다.
`datetime_day_name(DAY)`	문자열	주어진 DAY의 전체 이름을 리턴합니다. 인수는 1(일요일) - 7(토요일) 범위의 정수여야 합니다.
`datetime_hour(TIME)`	정수	TIME 또는 시간소인의 시간을 리턴합니다. 결과는 0 - 23 범위의 정수입니다.
`datetime_in_seconds(TIME)`	실수	TIME에 저장된 초 부분을 리턴합니다.
`datetime_in_seconds(DATE)`, `datetime_in_seconds(DATETIME)`	실수	현재 DATE 또는 DATETIME과 기준 날짜(1900-01-01) 간의 차이로부터 누적된 숫자(초로 변환됨)입니다.
`datetime_minute(TIME)`	정수	TIME 또는 시간소인의 분을 리턴합니다. 결과는 0 - 59 범위의 정수입니다.
`datetime_month(DATE)`	정수	DATE 또는 시간소인의 월을 리턴합니다. 결과는 1 - 12 범위의 정수입니다.
`datetime_month_name (MONTH)`	문자열	주어진 MONTH의 전체 이름을 리턴합니다. 인수는 1 - 12 범위의 정수여야 합니다.
`datetime_now`	시간소인	현재 시간을 시간소인으로 리턴합니다.
`datetime_second(TIME)`	정수	TIME 또는 시간소인의 초를 리턴합니다. 결과는 0 - 59 범위의 정수입니다.
`datetime_day_short_name` `(DAY)`	문자열	주어진 DAY의 축약 이름을 리턴합니다. 인수는 1(일요일) - 7(토요일) 범위의 정수여야 합니다.
`datetime_month_short_name` `(MONTH)`	문자열	주어진 MONTH의 축약 이름을 리턴합니다. 인수는 1 - 12 범위의 정수여야 합니다.
`datetime_time(HOUR, MINUTE, SECOND)`	시간	지정된 HOUR, MINUTE, SECOND의 시간 값을 리턴합니다. 인수는 정수여야 합니다.
`datetime_time(ITEM)`	시간	주어진 ITEM의 시간 값을 리턴합니다.
`datetime_timestamp(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND)`	시간소인	주어진 YEAR, MONTH, DAY, HOUR, MINUTE, SECOND의 시간소인 값을 리턴합니다.
`datetime_timestamp(DATE, TIME)`	시간소인	주어진 DATE 및 TIME의 시간소인 값을 리턴합니다.
`datetime_timestamp` `(NUMBER)`	시간소인	주어진 초 단위의 시간소인 값을 리턴합니다.
`datetime_weekday(DATE)`	정수	주어진 DATE 또는 시간소인의 요일을 리턴합니다.
`datetime_year(DATE)`	정수	DATE 또는 시간소인의 연도를 리턴합니다. 결과는 2002와 같은 정수입니다.
`date_weeks_difference` `(DATE1, DATE2)`	실수	DATE1이 나타내는 날짜 또는 시간소인부터 DATE2가 나타내는 날짜 또는 시간소인까지의 시간(주)을 실수로 리턴합니다. 이는 7.0일을 1주로 합니다. DATE2가 DATE1 이전인 경우 이 함수는 음수를 리턴합니다.
`date_years_difference (DATE1, DATE2)`	실수	DATE1이 나타내는 날짜 또는 시간소인부터 DATE2가 나타내는 날짜 또는 시간소인까지의 시간(년)을 실수로 리턴합니다. 이는 365.25일을 1년으로 한 대략적인 숫자입니다. DATE2가 DATE1 이전인 경우 이 함수는 음수를 리턴합니다.
`date_from_ywd(YEAR, WEEK, DAY)`	Integer	ISO 8601 표준을 사용하여 연도, 주(한 해 기준), 요일을 날짜로 변환합니다.
`date_iso_day(DATE)`	Integer	ISO 8601 표준을 사용하여 날짜의 요일을 리턴합니다.
`date_iso_week(DATE)`	Integer	ISO 8601 표준을 사용하여 날짜의 주(한 해 기준)를 리턴합니다.
`date_iso_year(DATE)`	Integer	ISO 8601 표준을 사용하여 날짜의 연도를 리턴합니다.
`time_before(TIME1, TIME2)`	Boolean	TIME1이 TIME2가 나타내는 시간 또는 시간소인 이전의 시간 또는 시간소인을 나타내는 경우 참 값을 리턴합니다. 그렇지 않으면 이 함수는 0 값을 리턴합니다.
`time_hours_difference (TIME1, TIME2)`	실수	TIME1과 TIME2가 나타내는 시간 또는 시간소인 간의 시차(시간)를 실수로 리턴합니다. 스트림 특성 대화 상자에서 롤오버 일/분(O)을 선택하는 경우 이전 일을 참조하기 위해 상위 값 TIME1을 사용합니다. 롤오버 옵션을 선택하지 않으면 상위 값 TIME1으로 인해 리턴된 값은 음수가 됩니다.
`time_in_hours(TIME)`	실수	TIME이 나타내는 시간(시간)을 실수로 리턴합니다. 예를 들어, `HHMM` 시간 형식에서 `time_in_hours('0130')` 표현식은 1.5로 평가됩니다. TIME은 시간 또는 시간소인을 나타낼 수 있습니다.
`time_in_mins(TIME)`	실수	TIME이 나타내는 시간(분)을 실수로 리턴합니다. TIME은 시간 또는 시간소인을 나타낼 수 있습니다.
`time_in_secs(TIME)`	정수	TIME이 나타내는 시간(초)을 정수로 리턴합니다. TIME은 시간 또는 시간소인을 나타낼 수 있습니다.
`time_mins_difference(TIME1, TIME2)`	실수	TIME1과 TIME2가 나타내는 시간 또는 시간소인 간의 시차(분)를 실수로 리턴합니다. 스트림 특성 대화 상자에서 롤오버 일/분(O)을 선택하는 경우 이전 일(또는 현재 형식에 분과 초만 지정된 경우 이전 시간)을 참조하기 위해 상위 값 TIME1을 사용합니다. 롤오버 옵션을 선택하지 않으면 상위 값 TIME1으로 인해 리턴된 값은 음수가 됩니다.
`time_secs_difference(TIME1, TIME2)`	정수	TIME1과 TIME2가 나타내는 시간 또는 시간소인 간의 시차(초)를 정수로 리턴합니다. 스트림 특성 대화 상자에서 롤오버 일/분(O)을 선택하는 경우 이전 일(또는 현재 형식에 분과 초만 지정된 경우 이전 시간)을 참조하기 위해 상위 값 TIME1을 사용합니다. 롤오버 옵션을 선택하지 않으면 상위 값 TIME1으로 인해 리턴된 값은 음수가 됩니다.