개발자 포트폴리오에 자바스크립트 Intl을 써봤더니

profile_image
작성자 서지후
댓글 0건 조회 1회

영문 소개보다 먼저 걸린 날짜와 숫자

포트폴리오용 예제 데이터부터 실행했습니다

프로젝트 설명을 영어로 바꿨는데 공개일과 비용은 한국식 표기 그대로라면 어떨까요? 저는 개발자 포트폴리오에 넣을 예제 데이터를 JavaScript 실행 환경에서 직접 출력하며 자바스크립트 Intl의 장단점을 살펴봤습니다. 날짜·금액·기술 목록의 표시 결과를 확인한 사용 후기입니다.

Andrey Vasiliev처럼 소프트웨어 개발과 디자인 프로젝트를 소개하는 사이트에서는 짧은 정보도 작업의 맥락을 전달합니다. 소개문 번역과 별도로 날짜와 숫자의 표시 규칙을 정해보는 것이 이번 실험의 출발점이었습니다.

번역 문장과 표시 형식을 나눴습니다

'포트폴리오'라는 용어는 네이버 지식백과의 Portfolio 항목과 포트폴리오 항목을 참고할 수 있으며, 여기서는 개발자가 작업물을 소개하는 개인 웹사이트를 대상으로 합니다.

  • 프로젝트 공개일: 달력상의 날짜와 실제 공개 시각을 구분해, 시간대가 바뀔 때 표시가 어떻게 달라지는지 확인했습니다.
  • 데모 금액: 실험용 숫자 12900에 원화와 달러 형식을 각각 적용했습니다. 이 숫자는 서비스 이용료나 실제 프로젝트 견적이 아닙니다.
  • 기술 목록: JavaScript, Linux, PHP를 배열로 준비했습니다. 손으로 이어 붙인 문자열과 비교하기 위한 입력입니다.

날짜가 하루 앞당겨져 원본 값부터 다시 봤습니다

같은 입력을 두 시간대로 출력했습니다

가장 눈에 띈 결과는 날짜였습니다. new Date('2026-11-21')을 Intl.DateTimeFormat에 전달하고 한국어 긴 날짜 형식으로 출력했더니, timeZone을 UTC로 지정한 경우에는 '2026년 11월 21일', America/Los_Angeles로 지정한 경우에는 '2026년 11월 20일'이 나왔습니다. 날짜만 넣었는데 시간대 선택이 결과에 영향을 준 것입니다.

시각이 포함된 입력도 확인했습니다. '2026-11-20T15:30:00Z'는 서울 설정에서 11월 21일 오전 12시 30분, 로스앤젤레스 설정에서 11월 20일 오전 7시 30분으로 표시됐습니다. 여러분의 프로젝트 카드에 필요한 정보가 '출시한 날'인지 '배포한 순간'인지 먼저 물어보면, 어떤 표시가 적절한지 판단하기 쉬워집니다.

언어 선택과 시간대 선택을 분리했습니다

재현할 때는 new Intl.DateTimeFormat('ko-KR', { dateStyle: 'long', timeZone: 'UTC' }).format(new Date('2026-11-21'))처럼 입력과 옵션을 한 줄에 드러내는 방식이 편했습니다. 로케일은 ko-KR로 유지하고 timeZone만 바꾸니 차이의 원인을 좁힐 수 있었습니다. 저는 공개일 필드에는 달력 날짜를, 배포 기록에는 시각과 기준 시간대를 명시하는 설계를 택하겠습니다.

표시할 정보예제 입력적용할 규칙
작품 공개일2026-11-21의도한 달력 날짜를 유지
배포 시각2026-11-20T15:30:00Z표시 시간대를 정해 변환
  1. 필드의 뜻을 먼저 적습니다. '날짜' 하나로 뭉뚱그리지 않고 공개일, 수정 시각, 행사 시작 시각처럼 역할을 구분합니다. 같은 화면에서도 필요한 처리 방식이 달라집니다.
  2. 경계 시각을 예제로 넣습니다. 이번처럼 서울에서 자정을 조금 지난 입력을 쓰면 날짜가 달라지는 상황을 쉽게 확인할 수 있습니다. 낮 시간의 예제 하나만 보면 차이를 놓치기 쉽습니다.
  3. 옵션을 하나씩 바꿉니다. 입력을 고정하고 언어와 시간대를 하나씩 바꾸니 차이의 원인을 이해하기 편했습니다.
프로젝트의 공개일을 다룰 때는 '어떤 모양으로 보일까'보다 '이 값이 달력 날짜인가, 실제 순간인가'를 먼저 결정해보세요.

금액과 기술 목록은 간결해졌지만 함정도 보였습니다

달러 기호가 붙어도 환전된 금액은 아니었습니다

숫자 12900을 Intl.NumberFormat으로 출력하니 ko-KR과 KRW 조합에서는 '₩12,900', en-US와 USD 조합에서는 '$12,900.00'이 나왔습니다. 자릿수 구분과 통화 기호를 직접 이어 붙이지 않아도 되어 편했지만, 같은 숫자에 다른 통화 표시가 붙었다는 점이 핵심입니다. 12,900원을 달러 가치로 환산한 결과로 읽으면 안 됩니다.

따라 해보려면 new Intl.NumberFormat('ko-KR', { style: 'currency', currency: 'KRW' }).format(12900)부터 실행하면 됩니다. 다국어 프로젝트에서 언어 버튼을 바꿀 때 통화 코드까지 무조건 따라 바꾸는 설계는 피하고 싶었습니다. 영문 페이지에서도 원화 견적의 통화 단위는 독자가 알 수 있어야 합니다.

기술 이름은 유지하고 연결 표현만 바꿨습니다

Intl.ListFormat에는 ['JavaScript', 'Linux', 'PHP']를 넣고 style은 long, type은 conjunction으로 지정했습니다. 이번 실행에서는 한국어가 'JavaScript, Linux 및 PHP', 영어가 'JavaScript, Linux, and PHP'로 나왔습니다. 기술 이름 자체는 그대로이고 연결 표현이 달라진다는 결과가 인상적이었습니다. 프로젝트 설명 전체를 번역하는 기능으로 기대하기보다는 반복되는 짧은 정보에 쓰기 좋았습니다.

  • 좋았던 점: 이번 실험에는 유료 번역 API나 외부 패키지를 추가하지 않았습니다. 입력과 옵션을 전달해 결과를 비교하니 작은 기능을 검토하기 편했습니다.
  • 아쉬웠던 점: 표기가 자연스러워져도 원본 데이터의 의미까지 해결되지는 않았습니다. 금액의 통화와 날짜의 기준은 개발자가 별도로 정해야 하므로, 화면에 보이는 결과만 확인하고 끝내기 어렵습니다.
  • 사용 팁: 기술 목록을 각각 클릭할 수 있는 배지로 만들 계획이라면 문장 형태로 합칠 필요가 없습니다. 저는 소개문 안의 나열에는 목록 포맷을, 필터와 연결되는 기술 표시는 개별 요소를 쓰겠습니다.
통화 기호가 바뀐 화면을 확인할 때는 숫자도 함께 보세요. 이번 예제의 12900은 원화 출력과 달러 출력에서 같은 입력값이었습니다.

한국어 포트폴리오에도 지금 넣어야 할까요

표시할 데이터가 반복되는지부터 봅니다

실험 뒤 가장 먼저 떠오른 질문은 '한국어로만 운영하는 개인 사이트에도 Intl을 적용할 필요가 있을까?'였습니다. 제 기준에서는 언어 수보다 반복되는 데이터와 변경 가능성이 우선입니다. 날짜와 숫자가 거의 없는 소개 페이지라면 이 실험만으로 큰 개선을 기대하기 어렵지만, 프로젝트마다 공개일과 측정값을 보여준다면 표시 규칙을 한곳에 모을 이유가 생깁니다.

다만 저는 이번 출력 실험으로 속도 향상이나 검색 순위 개선까지 확인하지는 않았습니다. 얻은 것은 입력값, 로케일, 시간대, 통화 옵션이 어떤 결과를 만드는지 직접 비교한 기록이며, 실제 웹사이트에 적용할 때는 기존 화면의 디자인과 데이터 의미까지 이어서 확인해야 합니다.

프로젝트 카드 하나로 적용 범위를 판단합니다

처음 적용한다면 전체 사이트를 바꾸기보다 카드 한 개의 날짜부터 옮겨보겠습니다. 날짜 표시 함수에 입력과 기준을 모으고, 그 카드가 필요한 언어와 시간대에서 어떻게 보이는지 확인하는 순서입니다. 오류가 있는 입력을 정상 날짜처럼 보여주지 않도록 처리 방법도 정하면, 단순한 형식 변경을 넘어 소프트웨어 프로젝트의 데이터 설계를 설명하는 사례로 남길 수 있습니다.

  1. 실제 필드 하나를 고릅니다. 공개일과 수정일을 동시에 손대지 말고 의미가 분명한 값부터 선택합니다. 변경 전후의 화면에서 확인할 항목도 적습니다.
  2. 빈 값 처리부터 정합니다. 아직 공개하지 않은 작업이라면 날짜를 억지로 만들기보다 '공개 예정'처럼 상태에 맞는 문구를 준비합니다. 숫자 예제에도 값 없음과 실제 0을 별도로 넣어 확인합니다.
  3. README에 재현 예제를 남깁니다. 입력값, 지정한 옵션, 실행 환경, 실제 출력 결과를 함께 적습니다. 특히 이번에 확인한 11월 21일과 20일의 차이를 남기면, 다음에 시간대 설정을 바꾸는 사람이 공개일의 의미를 다시 검토할 수 있습니다.

개발자 포트폴리오에 자바스크립트 Intl을 써봤더니

댓글목록

등록된 댓글이 없습니다.