Styxis
Company
Knowledge

PyArrow date32 변환: 정수 list와 NumPy 배열의 계약 맞추기

같은 숫자라도 컨테이너별 변환 경로와 날짜 단위를 함께 확인한다.

날짜 값과 변환 경로를 따로 기록한다

날짜의 단위 계약과 입력 컨테이너가 지원하는 변환 경로를 함께 명시해야 한다. 정수 1은 기준과 단위가 있어야 날짜가 된다. 같은 숫자 목록을 다른 컨테이너로 전달했을 때 생기는 오류를 데이터가 없다는 의미로 바꾸면 안 된다. [1, 2, 3]

list는 성공하고 NumPy 배열은 실패한 보고

PyArrow 26.0.0과 NumPy 2.5.4 보고는 [0, 1, 2] list를 date32로 만들면 1970년 1월 1일부터 3일까지가 나온다고 제시한다. 같은 값의 NumPy 배열에서는 int64에서 date32로의 cast가 지원되지 않는다는 오류가 나온다. 이 자료는 숫자가 틀렸다는 결론보다 두 입력 경로의 지원 범위가 다르다는 근거다. [1]

변환 경계를 명시한다

정수를 날짜로 받는 경계에서 epoch와 days 단위를 문서화하고 컨테이너별 명시적 변환 경로를 대조한다. 실패한 배열을 빈 표로 대체하지 않는다. container_kind와 integer_day를 남기고 성공 경로의 결과를 같은 ISO 날짜 형식으로 비교한다. 초나 밀리초 값을 days로 오인하면 지원되는 경로에서도 다른 날짜가 만들어질 수 있으므로 단위 계약을 전처리 앞에 둔다. [1, 3]

epoch 다음 날을 기준으로 삼는 사례

설명용 계약에서 0은 1970-01-01, 1은 그다음 날로 정의한다. 입력 1의 결과가 1970-01-02이면 정상이고 1970-01-01이면 실패다. Truthound Core의 ColumnPairValidator는 성공적으로 변환한 ISO 날짜와 독립적으로 만든 기준 날짜를 비교할 수 있다. 지원되지 않는 Arrow cast를 추가하거나 실패한 변환을 복구하는 기능은 아니다. 실패 상태는 값 비교와 구분해 원래 요청에 연결한다. [1, 2, 3]

적용 조건

container_kind, integer_day, expected_iso_date, converted_iso_date 표를 원본 또는 독립 대조 경로에서 준비하고 관측 대상과 동일한 실행·파일·키 범위로 연결한다.

대안

컨테이너에 맞는 명시적 날짜 변환을 먼저 수행한다.

한계

  • Truthound가 지원하지 않는 Arrow cast를 추가하지 않는다. 정수가 초나 밀리초인 경우 date32 날짜 계약으로 읽으면 안 된다.

근거

사건 확인일
대상 확인일
수정일