PY 함수

적용 대상
Microsoft 365용 Excel Mac용 Microsoft 365용 Excel

셀에 =PY 를 입력하고 자동 완성 메뉴에서 PY 함수를 선택하면 셀 편집 환경이 Python 편집기로 변환됩니다. 자세한 내용은 Excel에서 Python 소개 및 Excel에서Python 시작을 참조하세요

중요

PY 함수는 Excel의 수식 입력줄에서 직접 입력하거나 볼 수 없으며, 대신 Python 편집기에서 PY 함수를 생성하여 셀에 삽입합니다. PY 함수 구문은 주로 추가 기능에서 Python 수식을 직접 삽입하거나 읽는 데 사용됩니다. Python 수식이 포함된 셀에서 FORMULATEXT 함수를 사용할 때도 볼 수 있습니다. 

구문

PY 함수는 보안 Microsoft Cloud 런타임에서 Python 코드를 실행합니다. 결과는 Python 개체 또는 Excel 값으로 반환됩니다. 

=PY(python_code,return_type) 

인수 설명
python_code
(필수)
보안 Microsoft Cloud 런타임에서 실행할 Python 코드입니다. 정적 텍스트여야 합니다.
return_type
(필수)
원하는 반환 형식을 지정합니다. 정적 숫자 0 또는 1이어야 합니다.
  • 0은 Excel 값을 나타냅니다.
  • 1은 Python 개체를 나타냅니다.

Excel 참조

Python 코드는 사용자 지정 Python 함수를 사용하여 Excel에서 값을 참조할 수 있습니다. xl().  

함수는 xl() 다음 Excel 개체 참조를 지원합니다.

  • 범위
  • 이름
  • 테이블​​
  • 이미지
  • 파워 쿼리 연결

함수는 xl() 선택적 헤더 인수를 지원합니다. headers 인수는 첫 번째 행에 헤더가 있는지 여부를 지정합니다. 예를 들어 는 xl("A1:Z10", headers=True)A1:Z1 셀이 머리글임을 나타냅니다. 

주의

  • PY 함수는 FORMULATEXT에서 볼 수 있으며 추가 기능으로 작성 및 읽을 수 있습니다.
  • PY 함수는 Python 편집기를 사용하여 표시되므로 수식 입력줄에 표시되지 않습니다
  • PY 함수는 다른 Excel 함수와 함께 사용할 수 없습니다. 다른 함수와 함께 사용하면 수식을 입력할 수 없습니다.
  • python_code 인수와 return_type 인수는 모두 정적이어야 합니다.

예제

예제 1에서는 Python plus 연산자를 사용하여 3개의 텍스트 조각에서 "헬로 월드"를 생성합니다. 

=PY('Hello' + ' ' + 'World',0) 

 ———————————————————————————

예제 2에서는 함수를 xl() 사용하여 Table1 에서 데이터를 가져오고 결과를 Python 개체로 반환합니다. 

=PY("xl(""Table1[#All]"", headers=True)",1)