A série Pandas é um ndarray unidimensional com rótulos de eixo. Os rótulos não precisam ser exclusivos, mas devem ser do tipo hashable. O objeto suporta indexação baseada em inteiros e rótulos e fornece uma série de métodos para executar operações envolvendo o índice.

A Series.item()função Pandas retorna o primeiro elemento dos dados subjacentes do objeto da série fornecido como um escalar python.

Observação: esta função só pode converter uma matriz de tamanho 1 em um escalar Python

Sintaxe: Series.item()

Parâmetro: Nenhum



Retorna: escalar

Exemplo # 1: Use a Series.item()função para retornar o primeiro elemento do objeto de série fornecido como um escalar.

# importing pandas as pd
import pandas as pd
  
# Creating the Series
sr = pd.Series([248])
  
# Create the Index
index_ = ['Coca Cola']
  
# set the index
sr.index = index_
  
# Print the series
print(sr)

Saída :

Agora usaremos a Series.item()função para retornar o primeiro elemento do objeto de série fornecido como um escalar.

# return a scalar
result = sr.item()
  
# Print the result
print(result)

Saída :


Como podemos ver na saída, a Series.item()função retornou com sucesso um valor escalar.
 
Exemplo # 2: Use a Series.item()função para iterar sobre todos os elementos no objeto de série fornecido.

# importing pandas as pd
import pandas as pd
  
# Creating the Series
sr = pd.Series([11])
  
# Create the Index
index_ = pd.date_range('2010-10-09', periods = 1, freq ='M')
  
# set the index
sr.index = index_
  
# Print the series
print(sr)

Saída :

Agora usaremos a Series.item()função para retornar o primeiro elemento do objeto de série fornecido como um escalar.

# return a scalar
result = sr.item()
  
# Print the result
print(result)

Saída :

Como podemos ver na saída, a Series.item()função retornou com sucesso um valor escalar.