맨위로가기
 

SBGRID

닫기

열 포맷(format)

그리드 각 열의 포멧을 설정 합니다. 실제 데이터는 format의 적용을 받아 변경되지 않고, 화면에 보이는 부분만 적용됩니다. 그리드 열 속성의 확장 속성이므로 필수 속성이 아닌, 선택 속성 입니다.
 

상세설명

format

  • 설정 : SBGridProperties.columns = [ { format : { type: value1, rule: value2, origin: value3, locale : value4, usetime : value5, callback : value6, range : value7, textareaheight : value8 } } ];
    • value1(필수) : [string] 표현하려는 데이터의 타입
      • 'date'     : 날짜 또는 시간 형식
      • 'number'  : 자릿수 구분 또는 소수점 표시 형식
      • 'string'   : 특정 문자 형식
      • 'custom'   : 사용자 지정 형식
      • 'mask'   : 특정 자리수 문자 지정 형식
    • value2(필수) : [string] 표현하려는 데이터의 형태 (날짜 시간 동시에 표시할 경우 rule에 날짜 부분은 대문자로 선언)
      • (date) 'yyyy'|'yy'      : 4자리 또는 2자리 년 표시
      • (date) 'mmm'|'mm'|'m'  : '월' 출력 또는 2자리 또는 1자리 월 표시
      • (date) 'do'|'dd'|'d'      : '일' 출력 또는 2자리 또는 1자리 일 표시
      • (date) 'HH'|'hh'        : 24시간 또는 12시간 표시
      • (date) 'mm'|'m'       : 2자리 또는 1자리 분 표시 (날짜 시간 동시에 표시할 경우 'nn'|'n' 으로 설정)
      • (date) 'ss'|'s'          : 2자리 또는 1자리 초 표시
      • (number) '000.0'      : 빈자리를 0으로 표시, 소수점 둘째자리 이하 버림
      • (number) '#,###.##'      : 3자리마다 '.' 표시, 유효한 자리만 표시, 소수점 셋째자리 이하 버림
      • (string) '@ "님"'        : @ 문자 표시
      • (string) '"양수";"음수"'   : 데이터 값에 따라 양수와 음수로 조건부 표시. 0 미만인 숫자만 음수로 표시
      • (string) '# ?/?'        : 실수를 분수 형태로 표시
      • (string) '#,### "원"'     : 숫자 자리수 구분 및 글자 동시 표시
      • (mask) '문자'         : 지정한 범위에 바꿀 문자
    • value3(선택, 'type' 이 'date' 일 경우에만 필수) : [string] date 포맷 적용시 원본 데이터 형태 (날짜 시간 동시에 표시할 경우 origin에 날짜 부분은 대문자로 선언)
      • (date) 'yyyy'|'yy'      : 4자리 또는 2자리 년 표시
      • (date) 'mmm'|'mm'|'m'  : '월' 출력 또는 2자리 또는 1자리 월 표시
      • (date) 'do'|'dd'|'d'      : '일' 출력 또는 2자리 또는 1자리 일 표시
      • (date) 'HH'|'hh'        : 24시간 또는 12시간 표시
      • (date) 'mm'|'m'       : 2자리 또는 1자리 분 표시 (날짜 시간 동시에 표시할 경우 'nn'|'n' 으로 설정)
      • (date) 'ss'|'s'          : 2자리 또는 1자리 초 표시
    • value4(선택) : [string] date 및 number 포맷 적용시 locale 에 따라 Default Format 및 표시 상태가 달라지도록 선언
      • (date, number)'ko'(default)  : 한국 표시 형식
      • (date, number)'us'     : 미국 표시 형식
    • value5(선택) : [boolean] date 포맷 형태에 시분초 표시 여부
      • (date) true (default)   : 시분초 표시 (날짜 시간 동시에 표시할 경우 rule에 날짜 부분은 대문자로 선언)
      • (date) false              : 시분초 표시하지 않음
    • value6(선택) : [string | object] custom 포맷 형태 사용시 호출하는 사용자가 원하는 형태의 function
      • (custom) param1 : 실제 데이터
    • value7(선택) : [number : number] mask 시킬 문자 지정 범위 (mask 기능 사용시 필수)
      • (mask) number : number : 문자 범위 지정
    • value8(선택) : [string] 'number' 타입 format 사용시 데이터가 빈 값일 경우 보여줄 문자열을 설정하는 속성
      • (string) : 빈 값일 경우 보여줄 문자열

예시