YII 类库手册

protected function __construct($id)
{
    $this->_id=self::getCanonicalID($id);
    $dataPath=self::$dataPath===null ? dirname(__FILE__).DIRECTORY_SEPARATOR.'data' : self::$dataPath;
    $dataFile=$dataPath.DIRECTORY_SEPARATOR.$this->_id.'.php';
    if(is_file($dataFile))
        $this->_data=require($dataFile);
    else
        throw new CException(Yii::t('yii','Unrecognized locale "{locale}".',array('{locale}'=>$id)));
}

public function getAMName()
{
    return $this->_data['amName'];
}

public static function getCanonicalID($id)
{
    return strtolower(str_replace('-','_',$id));
}

public function getCurrencyFormat()
{
    return $this->_data['currencyFormat'];
}

public function getCurrencySymbol($currency)
{
    return isset($this->_data['currencySymbols'][$currency]) ? $this->_data['currencySymbols'][$currency] : null;
}

public function getDateFormat($width='medium')
{
    return $this->_data['dateFormats'][$width];
}

public function getDateFormatter()
{
    if($this->_dateFormatter===null)
        $this->_dateFormatter=new CDateFormatter($this);
    return $this->_dateFormatter;
}

public function getDateTimeFormat()
{
    return $this->_data['dateTimeFormat'];
}

public function getDecimalFormat()
{
    return $this->_data['decimalFormat'];
}

public function getEraName($era,$width='wide')
{
    return $this->_data['eraNames'][$width][$era];
}

public function getId()
{
    return $this->_id;
}

public static function getInstance($id)
{
    static $locales=array();
    if(isset($locales[$id]))
        return $locales[$id];
    else
        return $locales[$id]=new CLocale($id);
}

public function getLanguage($id)
{
    return $this->getLocaleDisplayName($id, 'languages');
}

public function getLanguageID($id)
{
    // normalize id
    $id = $this->getCanonicalID($id);
    // remove sub tags
    if(($underscorePosition=strpos($id, '_'))!== false)
    {
        $id = substr($id, 0, $underscorePosition);
    }
    return $id;
}

public function getLocaleDisplayName($id=null, $category='languages')
{
    $id = $this->getCanonicalID($id);
    if (isset($this->_data[$category][$id]))
    {
        return $this->_data[$category][$id];
    }
    else if (($category == 'languages') && ($id=$this->getLanguageID($id)) && (isset($this->_data[$category][$id])))
    {
        return $this->_data[$category][$id];
    }
    else if (($category == 'scripts') && ($id=$this->getScriptID($id)) && (isset($this->_data[$category][$id])))
    {
        return $this->_data[$category][$id];
    }
    else if (($category == 'territories') && ($id=$this->getTerritoryID($id)) && (isset($this->_data[$category][$id])))
    {
        return $this->_data[$category][$id];
    }
    else {
        return null;
    }
}

public static function getLocaleIDs()
{
    static $locales;
    if($locales===null)
    {
        $locales=array();
        $dataPath=self::$dataPath===null ? dirname(__FILE__).DIRECTORY_SEPARATOR.'data' : self::$dataPath;
        $folder=@opendir($dataPath);
        while(($file=@readdir($folder))!==false)
        {
            $fullPath=$dataPath.DIRECTORY_SEPARATOR.$file;
            if(substr($file,-4)==='.php' && is_file($fullPath))
                $locales[]=substr($file,0,-4);
        }
        closedir($folder);
        sort($locales);
    }
    return $locales;
}

public function getMonthName($month,$width='wide',$standAlone=false)
{
    if($standAlone)
        return isset($this->_data['monthNamesSA'][$width][$month]) ? $this->_data['monthNamesSA'][$width][$month] : $this->_data['monthNames'][$width][$month];
    else
        return isset($this->_data['monthNames'][$width][$month]) ? $this->_data['monthNames'][$width][$month] : $this->_data['monthNamesSA'][$width][$month];
}

public function getMonthNames($width='wide',$standAlone=false)
{
    if($standAlone)
        return isset($this->_data['monthNamesSA'][$width]) ? $this->_data['monthNamesSA'][$width] : $this->_data['monthNames'][$width];
    else
        return isset($this->_data['monthNames'][$width]) ? $this->_data['monthNames'][$width] : $this->_data['monthNamesSA'][$width];
}

public function getNumberFormatter()
{
    if($this->_numberFormatter===null)
        $this->_numberFormatter=new CNumberFormatter($this);
    return $this->_numberFormatter;
}

public function getNumberSymbol($name)
{
    return isset($this->_data['numberSymbols'][$name]) ? $this->_data['numberSymbols'][$name] : null;
}

public function getOrientation()
{
    return isset($this->_data['orientation']) ? $this->_data['orientation'] : 'ltr';
}

public function getPMName()
{
    return $this->_data['pmName'];
}

public function getPercentFormat()
{
    return $this->_data['percentFormat'];
}

public function getPluralRules()
{
    return isset($this->_data['pluralRules']) ? $this->_data['pluralRules'] : array();
}

public function getScientificFormat()
{
    return $this->_data['scientificFormat'];
}

public function getScript($id)
{
    return $this->getLocaleDisplayName($id, 'scripts');
}

public function getScriptID($id)
{
    // normalize id
    $id = $this->getCanonicalID($id);
    // find sub tags
    if(($underscorePosition=strpos($id, '_'))!==false)
    {
        $subTag = explode('_', $id);
        // script sub tags can be distigused from territory sub tags by length
        if (strlen($subTag[1])===4)
        {
            $id = $subTag[1];
        }
        else
        {
            $id = null;
        }
    }
    else
    {
        $id = null;
    }
    return $id;
}

public function getTerritory($id)
{
    return $this->getLocaleDisplayName($id, 'territories');
}

public function getTerritoryID($id)
{
    // normalize id
    $id = $this->getCanonicalID($id);
    // find sub tags
    if (($underscorePosition=strpos($id, '_'))!== false)
    {
        $subTag = explode('_', $id);
        // territory sub tags can be distigused from script sub tags by length
        if (strlen($subTag[1])<4)
        {
            $id = $subTag[1];
        }
        else
        {
            $id = null;
        }
    }
    else
    {
        $id = null;
    }
    return $id;
}

public function getTimeFormat($width='medium')
{
    return $this->_data['timeFormats'][$width];
}

public function getWeekDayName($day,$width='wide',$standAlone=false)
{
    if($standAlone)
        return isset($this->_data['weekDayNamesSA'][$width][$day]) ? $this->_data['weekDayNamesSA'][$width][$day] : $this->_data['weekDayNames'][$width][$day];
    else
        return isset($this->_data['weekDayNames'][$width][$day]) ? $this->_data['weekDayNames'][$width][$day] : $this->_data['weekDayNamesSA'][$width][$day];
}

public function getWeekDayNames($width='wide',$standAlone=false)
{
    if($standAlone)
        return isset($this->_data['weekDayNamesSA'][$width]) ? $this->_data['weekDayNamesSA'][$width] : $this->_data['weekDayNames'][$width];
    else
        return isset($this->_data['weekDayNames'][$width]) ? $this->_data['weekDayNames'][$width] : $this->_data['weekDayNamesSA'][$width];
}